feff83cedc
Require a short help string for "ls"
...
The linter change will enforce it for scripts. Plugins always include
the line, and length will have to be checked manually.
2016-04-15 16:28:41 +10:00
7fe142ea76
add many missing section anchors to Plugins.rst
2016-04-12 20:09:41 -04:00
4536f3df71
Fix last typos
2016-04-11 09:30:05 +10:00
c2b4ee8d64
Ready for Stonesense docs PR
2016-04-11 09:30:05 +10:00
c09b4f6b47
Tweak developer docs
2016-04-11 09:30:05 +10:00
4b9696d295
Fix html redirection to the docs
...
Now redirects from top level to user-default location, and
if you're in the repo there's a new second redirect to the real docs.
2016-04-11 09:30:05 +10:00
faec3b0cbc
Use local tables of contents in Plugins.rst
...
Makes it a lot easier to navigate the structure of the file.
2016-04-11 09:30:05 +10:00
7ebd50697e
Better formatting, TOCs in Lua API.rst
2016-04-11 09:30:05 +10:00
e0310e3050
Seperate HISTORY from NEWS
...
Because years-old information is not news any more!
2016-04-11 09:30:05 +10:00
b8bb8d0c92
Finish formatting, linking NEWS.rst
2016-04-11 09:30:05 +10:00
d07eb69a5e
Update Authors.rst
2016-04-05 12:04:32 -04:00
b97d33ca28
moveToBuilding improvements
...
- Don't set in_building by default when use_mode is 0 (consistent with most vanilla DF items)
- make use_mode optional and default to 0 (including in Lua API)
Resolves #885
2016-04-05 11:43:02 -04:00
5bb98295b3
Merge pull request #810 from PeridexisErrant/colonies
...
Colonies as a script, + place feature by Warmist
2016-03-13 08:32:05 -04:00
bc02e2a844
Add auto-gears mode for building hacks for automatic animation and gear positions.
2016-03-13 13:37:36 +02:00
e519313b70
Convert colonies plugin to script, add place feature
2016-02-01 18:12:38 +11:00
514ae890be
exportlegends-related documentation updates
2016-01-16 11:34:12 -05:00
53780d8232
New autogems plugin, automatically cutting rough gems.
2016-01-08 23:18:41 -07:00
d670ee8ab4
New tweak: block-labors
...
Prevents labors that can't be used from being toggled
Suggested at http://www.bay12forums.com/smf/index.php?topic=121451.msg6719464#msg6719464
2016-01-08 19:27:11 -05:00
974b427833
Add stonetoad to Authors.rst
2016-01-08 17:01:22 -05:00
2acdede03b
New tweak: hide-priority
...
Adds an option to hide designation priority indicators
2016-01-04 19:29:30 -05:00
81b055ee93
Implement "weather" as a script
2016-01-01 11:35:58 -05:00
d923633689
Add moversti, TheBloke, txtsd to Authors.rst
2016-01-01 11:34:52 -05:00
47bbdc8025
Merge pull request #778 from moversti/patch-3
...
Updated Windows compile docs
2016-01-01 11:27:31 -05:00
d087f4f741
Expose process MD5/PE to Lua (useful in export-dt-ini)
2015-12-27 14:59:18 -05:00
05926d9734
New tweak: title-start-rename
...
Adds a safe rename option to the title screen "Start Playing" menu
2015-12-26 11:47:58 -05:00
7d9f2d0c08
Updated Windows compile docs
...
Needing cmake.portable instead of cmake
2015-12-24 00:31:23 +02:00
285d48fb60
Merge pull request #774 from TheBloke/Docs_misc
...
Compile docs: Misc changes: Linux re building docs/pip; Windows re MSVC requirement and vs VStudio; Windows re command line compile with Bash.
2015-12-21 21:50:22 -05:00
ce0322e8fd
Word addition
2015-12-22 02:02:12 +00:00
203b6b967d
Windows: new section on using Bash to compile on command line under Windows
2015-12-22 01:57:39 +00:00
017afec271
Word order
2015-12-22 01:44:49 +00:00
df7edaf37d
Windows: clarification on requirement of MSVC vs Visual Studio and basic explanation why
2015-12-22 01:43:38 +00:00
5648adbc2c
Linux: Building docs: Some clarification on pip and sphinx-build
2015-12-22 01:39:39 +00:00
24ec588245
Merge branch 'develop' of https://github.com/dfhack/dfhack into develop
2015-12-21 20:38:29 -05:00
114c217d52
Remove createitem deprecation notice
2015-12-21 20:38:15 -05:00
b5e91d78aa
Typo
2015-12-20 21:33:02 +00:00
219a6c7a26
Compile docs: Windows: Add direct download link for MSVC 2010 SP1
2015-12-20 21:25:25 +00:00
5b1e2ff01f
Windows: soften the recommendation on Chocolatey to a 'preferred', also some improvements on the Chocolatey description re behaviour when software is already installed. And an update to the Manual Dependencies section.
2015-12-19 14:17:39 +00:00
03ec774142
OSX: fixed wording on DF path
2015-12-19 02:39:03 +00:00
7bfeb7cb2b
OSX: Removed dupe statement
2015-12-19 02:37:31 +00:00
895d5a534e
Fixes to: Linux: gcc-multilib; OSX: 10.11 notes higher/more emphasised; Windows: reason for why SP1 is required (currently unknown, so downgraded to 'we do not support' rather than a specific reason why it won't work.
2015-12-19 01:59:23 +00:00
e3b7cace60
Some re-wording in Building The Documentation, including some 80-char width (approx) re-formatting.
2015-12-15 22:04:10 +00:00
9bc8368d29
Further tweak to Enable documentation build re setting CMAke flag: mention GUI, update Windows advice.
2015-12-15 20:30:11 +00:00
6c7e5c9428
A few additions to the Windows section; more formatting changes including command highlighting; misc other tweaks.
2015-12-15 20:21:22 +00:00
196aec4cb4
+ again
2015-12-15 18:51:37 +00:00
2ded0e5ea9
Github->GitHub; git->Git (where not a command); one more change to Perlbrew section
2015-12-15 18:50:59 +00:00
e1777fcc6b
OSX: Simplify the new local Perl section, just mention what perlbrew as it's obvious enough how to use it from the webpage and most people probably won't be interested anyway.
2015-12-15 14:16:51 +00:00
417f9a26aa
Minor bullet point fixes in Mac list
2015-12-15 07:06:23 +00:00
1f928a8292
Typo
2015-12-15 06:16:48 +00:00
1afc0afb9c
Some further fixes, updates and elaborations. Had to convert the Mac list to bullet rather than numbered, as HTML numbering keeps breaking (resets to 1 in the middle of the list in several places) for reasons I can't figure out.
2015-12-15 06:08:25 +00:00
f26982f1e9
And other minor fixes (actually in this commit this time.)
2015-12-15 04:11:39 +00:00
5aae535394
Building documentation section: now with a non-stupid way of doing it! And other minor fixes.
2015-12-15 04:10:00 +00:00
21631b3712
Compile.rst: major updates to Windows and OSX sections; minor to Linux; new section re compiling documentation; many small fixes.
...
Introduction.rst: fix typo and remove erroneous end version for OSX.
2015-12-15 03:30:08 +00:00
df61233774
Merge remote-tracking branch 'PeridexisErrant/new-scripts' into develop
2015-11-26 16:13:27 -05:00
75f43b9bf6
Add @Enkrod to Authors.rst
...
Ref #743
2015-11-26 10:54:35 -05:00
d18dae45d8
Merge pull request #743 from Enkrod/patch-2
...
Typo Restrictliquid fixed
2015-11-26 10:52:57 -05:00
597ed1510e
Update documentation
...
Ref #741 , #744 , #747 , #748 , #749 , #756
2015-11-25 20:56:30 -05:00
14cf2790d2
Falconne deserves credit for a few great plugins.
2015-11-25 17:51:30 -07:00
842b9c5191
Implement feature as a script, add magma option
...
Functionality is exactly equivalent to the plugin, but with a new option
for players who want to enable magma furnaces without spoilers.
2015-11-17 16:43:56 +09:30
2ba9ef04e3
Replace drybuckets plugin with a script
...
Also closes #248 , by checking job and building flags.
2015-11-17 13:55:43 +09:30
9c62ff1d7f
Blacklist GCC 5 on Linux again
...
GCC 5 mangles some symbols, such as "plugin_globals" ->
"plugin_globals[abi:c++11]" (or "_Z14plugin_globalsB5cxx11"), even
when declared with 'extern "C"'. This breaks plugins, in particular.
2015-11-10 18:51:29 -05:00
72adb904f6
Document multilib packages
2015-11-10 16:57:38 -05:00
e209e3937a
Typo Restrictliquid fixed
...
restrictliquid is actually restrictliquids.
This time with lengthened underline for sphinx.
2015-11-10 07:50:38 +01:00
99b93ecd11
Move index back to root
2015-11-07 19:42:18 -05:00
52989ab40a
Update Compile.rst
2015-11-07 17:18:50 -05:00
6e8936faa7
Link to VS2010
...
Thanks to @TheBloke
http://stackoverflow.com/questions/3061811
2015-11-07 16:48:00 -05:00
1da42c9115
Add automaterial label
2015-11-07 15:55:21 -05:00
e176c3ea05
Merge remote-tracking branch 'PeridexisErrant/docs-again' into develop
2015-11-07 15:50:11 -05:00
0bb203e7c9
Replace initflags plugin with scripts
...
Progress towards #722
2015-11-07 23:42:14 +11:00
6dacbe3d9f
Add docs for "sort" and "diggingInvaders" plugins
...
I don't know how these were missed, but I've now checked everything
listed by "plug" but not (previously) a heading in Plugins.rst
2015-11-07 17:05:57 +11:00
3d801d45c6
Flatten plugin documentation
...
The obvious solution to not knowing how to categories plugins well is to
do so a little less. This commit does not rearrange them though, since
I thought that counterproductive without a better idea of what to do.
- removed many headings that are not commands
- fixed a few links and added some
- clarified stockpiles plugins
2015-11-07 14:01:18 +11:00
1c25f8f1a3
Unify docs for designation and map-mod plugins
...
Plus some cleanup and flattening of the behaviour mod plugin docs
2015-11-07 13:04:47 +11:00
a1110b36e8
Add shortlink for issues, update links
...
Also moved search above local table of contents in sidebar, which can
get very long.
2015-11-07 11:35:44 +11:00
3506921447
Add cross-links for similar commands
2015-11-07 10:53:12 +11:00
7f212178ca
Move unused docs to plugin source files
...
This way they can easily be restored when the plugins are reactivated,
but don't confuse users until then.
2015-11-07 10:13:21 +11:00
5826b49d09
Move index.rst to docs directory
...
Having the docs index in the repo root was a holdover from when it was
the README file. Now that it's not much use without being built, it's
better to leave the root to README, NEWS, and LICENSE - especially when
one is a html shortcut to the docs index.
2015-11-06 17:09:56 +11:00
193e71793a
Fix compile, intro, scripts
...
- script-syntax.py now exits with 1 instead of silently catching the
error if lua or ruby are missing
- index paths are absolute (from the repo root)
- less strong suggestion for third-party packs
- re-added lua-example and test-perlin doc
- corrected and clarified Compile some more
2015-11-06 16:58:58 +11:00
bc91928f8d
Explain ":foo" parsing mode in Core notes
2015-11-06 11:58:33 +11:00
2f8f5b071a
Merge pull request #730 from PeridexisErrant/add-scripts
...
Add updated emigration script, gui/family-affairs
2015-11-05 19:55:15 -05:00
18a921baef
Further clarify Core; move plugins out; other fixes
...
- Fix formatting of (c) in license
- Avoid possible issues with script linting
- Move plugin docs out of Core.rst
- Fix some builtin docs, tweak other bits
2015-11-06 11:44:43 +11:00
7fc2a226da
Add missing backtick
2015-11-05 19:37:51 -05:00
3cc0b34d73
Clean up other docs to match
...
Some deduplication in Scripts and Plugins, links in NEWS, add content
and link to files in index.
2015-11-06 10:15:21 +11:00
0ba6f73dcd
Add Introduction.rst, list builtins in Core.rst
...
The Introduction is the first page to read, and thus explains what
DFHack is, installation, basic use, and troubleshooting.
This frees up Core.rst for a detailed list of builtin commands (meant to
be complete, but I might have missed some), some other key commands, and
a discussion of init files. I also put the random notes that don't fit
anywhere at the bottom of this file.
2015-11-06 10:15:21 +11:00
3d9ba57121
Tidy and update Compile.rst
...
Eg removed workarounds for closed OSX bug, etc.
2015-11-06 10:15:20 +11:00
8aafcec0c8
Add unacknowledged contributors
...
Mostly authors of scripts which have been added.
2015-11-06 10:15:19 +11:00
45c3f145e5
Add gui/family-affairs
2015-11-05 13:17:26 +11:00
cbf31dcb37
Merge remote-tracking branch 'PeridexisErrant/NEWS-cleanup' into develop
2015-11-04 19:54:13 -05:00
6df0e26b05
Require 3rdparty docs to be in script source files
2015-11-02 09:32:50 +11:00
21ace4249a
Add 3rd-party script authors
2015-10-31 16:52:47 -04:00
96834923b9
Clean up Authors.rst
...
* Remove email addresses, following a discussion on IRC (these can be
found in git logs anyway, and having them publicly-visible invites
spam)
* Remove a couple duplicate authors
* Add a few aliases
2015-10-31 12:01:52 -04:00
6c832fadba
Add DoctorVanGogh to Authors.rst
...
See #715
2015-10-31 11:55:05 -04:00
45284fab17
Sort Authors.rst alphabetically
...
Previous changes combined the list of dfhack and stonesense
contributors, which interfered with the old, somewhat-time-based
order.
2015-10-31 11:51:12 -04:00
9b1d277ef5
Finish updating sphinx-build changes
...
Completes 5643119
2015-10-31 15:39:00 +11:00
4257940b22
fix typo in dig docs
2015-10-30 14:47:49 +11:00
5643119c71
Get docs building online
...
Readthedocs runs the build command in the directory conf.py is found,
and to work correctly that has to be the root directory.
2015-10-29 14:26:37 +11:00
a8ab595428
Tweak plugins docs
...
- Minor updates and clarifying edits
- Better use of markup throughout the document
- linked references to bugs and other things
- moved gui/siege-engine docs to the script
2015-10-29 12:46:31 +11:00
aee2655886
Merge branch 'develop' of https://github.com/DFHack/dfhack into NEWS-cleanup
2015-10-28 10:07:13 +11:00
5efea525e0
Split GitHub README from Sphinx index
...
The root of the documentation tree has a different function to the short
readme we want to display on GitHub, which now links to the main docs
(or Bay12 thread, or IRC). It also renders properly on GitHub, and can
use live-updating status badges because we don't expect it to work
offline.
2015-10-28 10:06:28 +11:00
c113d9b579
Format future news
2015-10-24 22:57:08 +11:00
a3803d340e
Build docs in place; copy inputs so users can build
...
Building the docs now works the same way, no matter when it happens - in
a cloned repo or distributed version.
This means all the relative links keep working; and that users or
downstream distributors can rebuild the docs with extra scripts or .rst
files in place.
Finally, it eliminates a large number of potential bugs which only occur
in one build environment and are difficult to reproduce.
Also add headings and this work to future news.
2015-10-24 22:19:52 +11:00
69090e114c
Explain script type at top of listing
...
Using an `about.txt` file in each directory. This is nice because it
keeps the purpose notes in the actual script directories.
2015-10-24 17:41:21 +11:00
PeridexisErrant
lethosor
expwnent
Warmist
Eric Wald
Lethosor
moversti
TheBloke
Sebastian Wolfertz