1
0
mirror of https://github.com/rkd77/elinks.git synced 2024-12-04 14:46:47 -05:00
elinks/doc/index.txt
2005-10-21 09:14:07 +02:00

92 lines
3.6 KiB
Plaintext

The ELinks Manual
Welcome! This is the entry point for the current humble ELinks manual.
It is by no way complete, it is not even very homogeneous and it should
be eventually superseded by a complete ELinks Book, which you can find
in the book/ subdirectory in a very prenatal stage.
There was a complete (or from a large part complete) manual for the
Links 0.82 once, you can still find it at:
http://links.sourceforge.net/docs/manual-0.82-en/index.html
While large parts of it do not apply anymore, you may still find some
relevant information there.
You may also refer to the manual page for a very quick reference,
however little effort is done to keep it always up-to-date.
On the other hand, the built-in documentation is _always_ up-to-date.
Check the --long-help and --config-help ELinks command-line arguments.
Table of contents
~~~~~~~~~~~~~~~~~
Introduction and Table of Contents .......................... index.txt
User's Guide
The ELinks Manual (txt) ............................ manual.txt
The ELinks Manual (html) .......................... manual.html
Other Topics
Frequently Asked Questions ................... faq.html
JavaScript/ECMAScript in ELinks ........ ecmascript.txt
Man pages (*)
elinks(1) ................................... man/man1/elinks.1
elinks.conf(5) ......................... man/man5/elinks.conf.5
elinkskeys(5) ........................... man/man5/elinkskeys.5
Developer's Guide
Internal Scripting (**)
The Lua Scripting Book ................ elinks-lua.texi
On the Perl Scripting Interface ........ (***) perl.pod
Events Reference Sheet (****) .............. events.txt
The Demented Guide to Source Hacking (*****) ...... hacking.txt
The Smallest Binary Quest Spoilerbook ............... small.txt
A Discursus on Color Models ................... color-model.txt
Appendices
Appendix A - Notes on User Feedback .............. feedback.txt
(*) 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
(**) By internal scripting, 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.
(***) This document is written in the Plain Old Documentation format,
traditional for any Perl-related documentation. You can either view
it directly by the 'perldoc' tool or convert it to a more reading-
-friendly format by one of the numerous 'pod2' tools, most notably
'pod2text' and 'pod2html'. All those tools should be part of your
Perl distribution (some Linux distributions have a separate 'perldoc'
package).
(****) De iure, this is not restricted to internal scripting and should
be of general interest. De facto, it is currently interesting almost
exclusively to hackers in the internal scripting area - and shall it
be very useful resource for internal scripting power users.
(*****) While that file 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.
(Note: Sometimes, I broke the lines manually earlier than gqap would,
for greater aesthetical effect. --pasky)
vim: textwidth=72