mirror of
https://github.com/rkd77/elinks.git
synced 2024-12-04 14:46:47 -05:00
ba6221c6f6
You can now use: make {all-docs,pdf,html,man,api,update-man}
instead of: make {all-docs,pdf-docs,html-docs,man-docs}
Away is building into separate dirs. This makes make able to actually get
dependencies right, since there are now a collection of 'common' build
rules, some of which have even been moved to use the cmd infrastructure.
To update the man pages there is a new update-man rule. It builds the
manual pages and copies them to their proper place under man/ while doing
the final preformatting.
As good thing is that the (two) man pages are moved to .txt files and
include the generated content.
The API building thing is also refined. It builds into api/ and builds it's
list of files dynamically by searching throught the .h files in the src/
directory. Documented header files must contain a comment like this:
/* API Doc :: <api-name> */
where <api-name> is the name used for the file under api/, for example
dom-scanner.
|
||
|---|---|---|
| .. | ||
| man | ||
| tools | ||
| .gitignore | ||
| .vimrc | ||
| asciidoc.conf | ||
| bittorrent.txt | ||
| bookmarks.txt | ||
| color-model.txt | ||
| dev-intro.txt | ||
| ecmascript.txt | ||
| elinks.1.txt | ||
| elinkskeys.5.txt | ||
| events.txt | ||
| exmode.txt | ||
| faq.txt | ||
| feedback.txt | ||
| hacking.txt | ||
| index.txt | ||
| installation.txt | ||
| introduction.txt | ||
| lua-scripting.txt | ||
| mailcap.txt | ||
| Makefile | ||
| manual.txt | ||
| marks.txt | ||
| mime.txt | ||
| perl.pod | ||
| README | ||
| remote.txt | ||
| small.txt | ||
| tabs.txt | ||
| terminals.txt | ||
| urlshortcuts.txt | ||
Overview of the ELinks documentation There is only limited documentation available for ELinks so far, sorry. It basically consists of the documents in this directory and the features.conf, README and INSTALL files in the project's root directory. The files you will find in this directory are manpages living in the man/ directory and a bunch of .html and especially .txt (wait, you expect HTML browser to carry its documentation around in HTML?) documents. The index.txt file contains the table of contents which should help you navigating between the files. Tools ----- The manual is written in asciidoc, however you will also need xmlto to process docbook XML generated by asciidoc into manpages and the html-chunked manual. If you want to translate .pod files you need pod2html. All these tools are checked by configure, thus to successfully build all the possible documentation (with the tools available on the system), just run $ make all-docs in the doc/ directory. Contributing ------------ Contributions are very warmly welcomed, whether it is fixing typos or bad grammar, rewritings or new material. Any information relevant to ELinks usage can be included in the manual, including FAQ material, tips and cheats ;) There is no strict codingstyle, but please don't limit your use of whitespaces and take a look at the style used in the current documents to get ideas of what is reasonable. Contributions should be sent to Jonas Fonseca <fonseca@diku.dk> or to the ELinks mailing list. If you are changing something in an existing document, please read about how to make unified patches in the Patches section of the doc/hacking.txt file.