1
0
mirror of https://github.com/rkd77/elinks.git synced 2024-12-04 14:46:47 -05:00
elinks/doc
Kalle Olavi Niemitalo 003d09ed78 elinks.conf.5: quoting corrections
In set and unset commands, the <option> must not be quoted.  In the
sample protocol.user.mailto.unix setting, the internal quotes were
using some manpage syntax, resulting in incorrect HTML output.
(cherry picked from commit 857c27e8b6)
2008-03-08 16:27:17 +02:00
..
man Minor fixes and improvements to option strings 2008-03-03 03:03:11 +01:00
tools keys2doc: Change \"foo\" to "foo". 2008-03-08 16:27:16 +02:00
.gitignore Sync the doc/ changes from elinks-0.12 2006-01-29 12:52:19 +01:00
asciidoc.conf Add description and version info to manpages 2008-03-03 02:51:25 +01:00
bittorrent.txt Center some dialog examples 2006-01-29 10:18:45 +01:00
bookmarks.txt Change elinks.or.cz references to elinks.cz 2008-01-22 12:36:21 +01:00
color-model.txt Remove now useless $Id: lines. 2005-10-21 09:14:07 +02:00
dev-intro.txt Initial commit of the HEAD branch of the ELinks CVS repository, as of 2005-09-15 15:58:31 +02:00
ecmascript.txt Drop useless comment block now that CVS Id tags are gone 2006-01-10 14:11:52 +01:00
elinks.1.txt elinks(1): update and polish; leave out the platform section 2008-03-02 23:29:17 +01:00
elinks.conf.5.txt elinks.conf.5: quoting corrections 2008-03-08 16:27:17 +02:00
elinkskeys.5.txt Sync the doc/ changes from elinks-0.12 2006-01-29 12:52:19 +01:00
events.txt Strings corrections from Malcolm Parsons 2008-01-27 04:17:47 +00:00
exmode.txt Drop useless comment block now that CVS Id tags are gone 2006-01-10 14:11:52 +01:00
faq.txt Change elinks.or.cz references to elinks.cz 2008-01-22 12:36:21 +01:00
feedback.txt Drop useless comment block now that CVS Id tags are gone 2006-01-10 14:11:52 +01:00
hacking.txt Sync the doc/ changes from elinks-0.12 2006-01-29 12:52:19 +01:00
installation.txt Document that GNU Make >= 3.78 is needed, and check it. 2007-12-09 08:17:24 +02:00
introduction.txt Strings corrections from Malcolm Parsons 2008-01-27 04:17:47 +00:00
lua-scripting.txt lua-scripting: Revised examples for Lua 5.0. And other updates. 2007-05-01 12:22:44 +03:00
mailcap.txt Drop useless comment block now that CVS Id tags are gone 2006-01-10 14:11:52 +01:00
Makefile update-man: Install manpages to srcdir, not builddir. 2008-03-08 16:27:17 +02:00
manual.txt Sync the doc/ changes from elinks-0.12 2006-01-29 12:52:19 +01:00
marks.txt Drop useless comment block now that CVS Id tags are gone 2006-01-10 14:11:52 +01:00
mime.txt Drop useless comment block now that CVS Id tags are gone 2006-01-10 14:11:52 +01:00
perl.pod Strings corrections from Malcolm Parsons 2008-01-27 04:17:47 +00:00
README Sync the doc/ changes from elinks-0.12 2006-01-29 12:52:19 +01:00
remote.txt Fix misparsing of -remote URLs containing parenthesis (bug 830) 2006-12-04 21:58:21 +01:00
small.txt Drop useless comment block now that CVS Id tags are gone 2006-01-10 14:11:52 +01:00
tabs.txt Drop useless comment block now that CVS Id tags are gone 2006-01-10 14:11:52 +01:00
terminals.txt Drop useless comment block now that CVS Id tags are gone 2006-01-10 14:11:52 +01:00
urlshortcuts.txt Drop useless comment block now that CVS Id tags are gone 2006-01-10 14:11:52 +01:00

			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.

You are encouraged to get a copy of the ELinks manual. It tries to be a
complete book of all there is to know about ELinks. For example, most files
listed in the next section is in some way part of the ELinks manual.

Instructions on building the manual is given below. If you do not intend to
build it yourself either access it on the ELinks homepage or, if you
downloaded ELinks via a tarball, the manual should be in the html/ directory.


Where to start
--------------

This sections tries to give a quick overview of important files you will find
in this directory or it's children.

 - Man pages:

	elinks(1) ................................... man/man1/elinks.1
	elinks.conf(5) .............................. man/man5/elinks.conf.5
	elinkskeys(5) ............................... man/man5/elinkskeys.5

   Man pages are best viewed with the man program. The easiest way to do this
   is by telling the man program to look for man pages in the doc/man
   directory by using the -M switch. If you are standing in the top-level
   directory, you can do this by invoking the man program using:

	man -M doc/man elinks.conf

 - User's Guide:

	Getting ELinks up and running................ installation.txt
	Introduction to the World of ELinks ......... introduction.txt
	Frequently Asked Questions .................. faq.txt
	JavaScript/ECMAScript in ELinks ............. ecmascript.txt
	Notes on User Feedback ...................... feedback.txt
	The Smallest Binary Quest Spoilerbook ....... small.txt

   Note: The ELinks manual really should be read in one of the generated
   formats: html, html-chunked or pdf, however the entry point can be found in
   manual.txt and might be of some help, when deciding what other .txt
   documents to read in this directory.

 - Developer's Guide:

	Introduction to ELinks Developing ........... dev-intro.txt
	The Demented Guide to Source Hacking ........ hacking.txt

   The developing intro tries to explain some of the basic concepts in the
   ELinks internal. While the hacking guide contains great deal about general
   source code structure and especially guidelines regarding coding style,
   submitting patches etc., thus every aspiring developer should take the
   pains to read through it, do not forget to also look for README and similar
   text files in the subdirectories containing the relevant sources for
   detailed notes regarding given modules/subsystems. Additionally, it is
   possible to build API docs. More about this below.

	The Lua Scripting Book ...................... lua-scripting.txt
	Events Reference Sheet ...................... events.txt

   The above covers internal scripting, by which we mean scripting of the
   browser internals through embedded Lua, Guile or Perl scripts. ECMAScript
   scripts embedded in documents have nothing to do with that.


Building documentation
----------------------

The following tools are used for generating documentation in various formats:

 - asciidoc: the basic tool for lifting the .txt files to other formats.
 - xmlto: used for outputting chunked HTML and man pages. 
 - jw: used for pdf documents.
 - pod2html: used for perl docs.

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. It will build, if possibly, the manual in the following
manual formats (with tool requirements listed):

 - HTML one-file (asciidoc)
 - HTML chunked / multiple files (asciidoc + xmlto)
 - PDF (asciidoc + jw)

and the following man page formats:
 
 - HTML (asciidoc)
 - man / groff (asciidoc + xmlto)

Note: You do not need to build manpages. They are shipped with ELinks. However,
if you want to have the manpages to match your local configuration and changes
you can rebuild them (this is mostly an issue with elinks.conf(5) which might
otherwise contain options that is not supported by the version you install.

Note: You must first build the ELinks binary for "make all-docs" to work
successfully. The binary is used for getting option documentation.

The documentation can be installed with:

	$ make install-doc


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.