c15b01a79a
Autogenerate include-all.rst for scripts so that script documentation can be entirely encapsulated in lua files without updating anything else.
2015-09-27 02:45:11 -04:00
094aceff9e
Sphinx: locate dfhack-icon.ico properly.
2015-09-26 20:49:43 -04:00
d6821e6d66
Clean up .travis.yml
2015-09-26 20:05:32 -04:00
345da8b2ed
Comment out roses-init (shouldn't be run from dfhack.init).
2015-09-26 18:06:24 -04:00
6cc399561b
CMake: Only run Sphinx when necessary
2015-09-26 17:52:06 -04:00
792eefee9f
Fix argument to base/roses-init
2015-09-26 17:00:45 -04:00
b16e59b91c
Check for existence of save folder before attempting to log events
...
cur_savegame.save_dir can be populated when the save directory does
not yet exist after world generation (since the game can be aborted
at that stage without saving).
2015-09-26 14:26:44 -04:00
fa60ccdd52
Don't find scripts from the last loaded world's raw/scripts folder
2015-09-26 14:26:13 -04:00
b679a0c482
Update xml
2015-09-26 13:45:51 -04:00
441afcced5
Fix issues with detecting Sphinx
2015-09-26 13:28:06 -04:00
9c6611dfc3
Clean up CMakeLists.txt
2015-09-26 13:16:05 -04:00
f2696cfd3d
Show all missing submodule errors
2015-09-26 10:51:29 -04:00
2bcf74d74c
Merge branch 'develop' of https://github.com/dfhack/dfhack into develop
2015-09-26 10:46:45 -04:00
ec17685041
CMake: Add compiler checks and GCC version checks
2015-09-26 10:46:29 -04:00
79e904efa7
Merge pull request #702 from PeridexisErrant/documentation-updates
...
Documentation updates
2015-09-26 03:02:13 -04:00
e92d63d248
Final documentation changes
...
Squashes a couple of commits from the other branch onto the last one
here.
2015-09-26 16:50:02 +10:00
2302698b22
Consolidate binpatch docs. Closes #546
...
Binpatches aren't used much at the moment, so this has two purposes:
collate information so it's easier to write them again, and remove it
from other sections where it's useless.
Note that if the standalone binpatch.exe is removed, the 'patching on
disk' section can be cleanly removed from 'Using a patch' by deleting
lines 44-47 & 61-90.
2015-09-26 12:28:09 +10:00
b51e3f88f3
Use DFHack favicon, fix whitespace
2015-09-26 12:28:09 +10:00
d57e84fc0f
Document all missing plugins, update NEWS
...
Checked with a throwaway script, and added the missing entries. NEWS
now has a comment on how to use the file, which is only visible in the
raw text version. Added the documentation changes to NEWS.
2015-09-26 12:28:08 +10:00
00a261cc81
More internal links and consistent formatting
...
Links everywhere, and formatting throughout Plugins.rst
2015-09-26 12:28:07 +10:00
f25694d745
Only have one file named Readme
2015-09-26 12:28:07 +10:00
53d5d3b897
Add listing of 3rdparty scripts, in Scripts doc
...
This will automatically find any .rst documentation matching the
pattern, and include it.
2015-09-26 12:28:06 +10:00
e7cf96d12e
Format LICENSE - minimal content changes
...
No changes whatsoever are made to the licenses. Formatting is
consistent. Comments are cleaned up a little. Some quotation marks are
consistent. Added link target and links.
2015-09-26 12:28:06 +10:00
2c2406727f
More consistent formatting
...
Eg use of monospaced font, line length, internal links, added xml SYNTAX
to root table of contents.
2015-09-26 12:28:05 +10:00
0307b0830f
Plugins internal links, more formatting
2015-09-26 12:28:04 +10:00
a10c777f8f
Add basic section on documentation standards
...
I expect this to expand once we get autodoc up and running.
2015-09-26 12:28:04 +10:00
780a9f3677
Internal links and link targets, formatted tables
...
* Enabled internal links; a phrase in backticks is linked to the
corresponding link target and turns into the corresponding title.
* Linked all existing references in Scripts.rst
* Created corresponding link targets
* Fixed formatting of some tables of arguments.
2015-09-26 12:28:03 +10:00
5352d37967
BUILD_DOCS should be a visible CMake option.
2015-09-25 19:43:40 -04:00
dfe9ec90f2
Update XML.
2015-09-25 19:43:14 -04:00
3b97a897da
Update travis.
2015-09-25 19:15:21 -04:00
6d035dd323
Whitespace, syntax.
2015-09-25 19:13:22 -04:00
558caa24fb
More whitespace errors.
2015-09-25 19:08:42 -04:00
6d3409da39
Whitespace.
2015-09-25 18:56:47 -04:00
9b07ebbf97
Install documentation.
2015-09-25 18:53:46 -04:00
a188b9d567
Merge branch 'third-party-scripts' into develop
2015-09-25 17:48:25 -04:00
8cc0a0bd42
Include all Roses' scripts.
2015-09-25 17:41:25 -04:00
3120c95842
Add maxthyme/prefchange.
2015-09-25 17:18:45 -04:00
b2801eb909
Third party scripts, fix lethosor, add maxthyme.
2015-09-25 17:13:32 -04:00
3c36a4cb07
Add more lethosor scripts.
2015-09-25 16:38:15 -04:00
5b5dd3aeae
Remove Makefile.
2015-09-25 09:24:37 -04:00
cc752a582e
Initial CMake version of Sphinx stuff.
2015-09-24 02:09:23 -04:00
d2a1a94368
Merge pull request #693 from PeridexisErrant/sphinx-experiments
...
Use Sphinx for generating documentation.
2015-09-23 23:51:52 -04:00
5bcff42800
Add third party scripts.
2015-09-23 23:46:26 -04:00
79263847a6
Get version string for docs from CMakeLists.txt
...
Because it's better to have a single source.
Someone else will need to integrate the makefiles though.
2015-09-24 13:33:56 +10:00
ce09c8e099
NEWS markup for titles; changelog entries linkable
...
Some very light markup is all that's needed. The underline with ====
makes each version into a linkable title and allows a table of contents
to be generated, while the `::` and blank line denotes that the rest is
a literal block.
I also shortened some very long lines, for readability.
2015-09-23 15:44:00 +10:00
8661f5dc4f
Add linter to check scripts are in readme, pass it
...
We knew a fair few were missing, but this was more than I expected.
2015-09-23 15:25:41 +10:00
27cee0525c
Change back to default make.bat name
...
We'll need to hook building docs into the main build process at some
point, but this is good for now.
2015-09-23 14:21:10 +10:00
5ba656bf79
Include changelog and licenses in generated docs
...
We may want to use .rst formatting for these eventually, and maybe move
the NEWS file to docs/News.rst and docs/History.rst - but for now
including the raw text works well enough.
2015-09-23 11:03:26 +10:00
9d1baac6a0
Note issue with multidimensional arrays in lua
...
Closes #597 . Also remove old TODO in readme.
2015-09-23 10:38:46 +10:00
bc5f7f329a
Add top-level redirect page for the docs
...
Because otherwise the pretty docs are buried and that doesn't help
anyone.
2015-09-23 10:17:25 +10:00
expwnent
lethosor
PeridexisErrant