Jonas Fonseca
cae0d9d8a6
Add some more comments
2006-01-12 03:16:37 +01:00
Jonas Fonseca
247b3c4623
Don't masq calls
2006-01-11 11:12:03 +01:00
Jonas Fonseca
ba6221c6f6
Redo the whole doc/ build thing
...
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.
2006-01-11 11:02:43 +01:00
Jonas Fonseca
fe7c2391d6
Fix typo
2006-01-11 10:31:39 +01:00
Laurent MONIN
c4ab3629f0
Add a note about mode_t and S_I???? macros.
2006-01-11 00:11:39 +01:00
Laurent MONIN
7af11c507f
More dependencies.
2006-01-10 22:18:03 +01:00
Laurent MONIN
1ac97927b5
Make $(MAN_DIR)/man5/elinkskeys.5 target depends on $(HELP2DOC) and
...
Makefile.
2006-01-10 22:11:14 +01:00
Laurent MONIN
e833c444f5
Remove obsolete elinksmanual(1) link.
2006-01-10 22:10:37 +01:00
Jonas Fonseca
4f20c950b5
Remove useless FAQ entry
2006-01-10 18:55:06 +01:00
Jonas Fonseca
6bd67a6f09
Preprocess elinks.1.in and elinkskeys.5 to add title and date fields
...
Regenerate all man pages.
2006-01-10 17:09:02 +01:00
Laurent MONIN
06dd1e2e06
Use date -I for man page date, suggested by lindi.
2006-01-10 16:15:32 +01:00
Laurent MONIN
3d837406d6
print_elinksconf_header(): fix quotes and backslashes
...
escaping. elinks.conf.5 was badly formatted.
2006-01-10 00:45:06 +01:00
Laurent MONIN
6b19a4fe1f
Enforce locales env vars to be sure elinks generate english texts,
...
even on systems using non-english locales.
2006-01-09 23:51:29 +01:00
Jonas Fonseca
d657060b74
Build html/api/dom.html
2006-01-09 22:48:09 +01:00
Jonas Fonseca
0e5853cae7
More perl snacks; added macro:[] for #define'd values; api dom/scanner.h
2006-01-09 14:06:47 +01:00
Jonas Fonseca
d7edca09c3
More perl snacks
2006-01-09 12:46:13 +01:00
Jonas Fonseca
2206f560c6
Build a DOM api from the two doctised header files
2006-01-09 12:45:50 +01:00
Jonas Fonseca
938c8a80b4
Support more implicit markup of source files
2006-01-09 11:01:36 +01:00
Jonas Fonseca
9799a66710
Code2doc v2.0
2006-01-09 08:25:03 +01:00
Jonas Fonseca
9699396658
Match against comment end once
2006-01-09 06:49:15 +01:00
Jonas Fonseca
9e23ea9eeb
Replace $first with $indent to get uniform indentation and simplify
2006-01-09 06:24:00 +01:00
Jonas Fonseca
cab1380031
Obsolete $start and $gotone; tune newlines; simply line matching
2006-01-09 05:30:59 +01:00
Jonas Fonseca
41fe69f86e
Handle one-liners with '/*:: ... */' upfront
2006-01-09 05:03:07 +01:00
Jonas Fonseca
4e8abf55ec
Cleanup; use Getopt::Std; Loop multiple files from cmdline with <>
2006-01-09 04:49:26 +01:00
Jonas Fonseca
2d7356d29a
Improve support for struct documentation by saving the struct name
...
This makes it easy to create
id:[$struct$member]::
One line description
2006-01-09 00:53:41 +01:00
Jonas Fonseca
a7fb4a71e3
Insert missing ':' after 'id', use tab for indentation
2006-01-09 00:01:09 +01:00
Jonas Fonseca
4aa57ffc59
Add asciidoc configuration file for output of code2doc
2006-01-09 00:00:10 +01:00
Jonas Fonseca
7acb3059a8
Make code2doc print to stdout
2006-01-08 23:57:14 +01:00
Jonas Fonseca
ac73ccce42
Merge with git+ssh://pasky/srv/git/elinks.git
2006-01-08 23:46:06 +01:00
Jonas Fonseca
61efbc4c9a
First attempt to build html/api docs
...
It only does src/dom/sgml/parser.h for now.
2006-01-08 23:44:59 +01:00
Russ Rowan
0eef02b8f3
Handle: SGML_PARSER_CODE_OK = 1, /**: The parsing was successful */
2006-01-08 17:42:04 -05:00
Jonas Fonseca
b70133760f
Make *-docs depend on doc-dirs; beware if you build individual files
2006-01-08 23:15:47 +01:00
Russ Rowan
0f8f5b0635
Undo last change and left align enums.
2006-01-08 16:57:10 -05:00
Russ Rowan
b2cbbf1139
Don't left align enums.
2006-01-08 16:46:46 -05:00
Jonas Fonseca
65c007d326
Merge with git+ssh://pasky/srv/git/elinks.git
2006-01-08 22:36:18 +01:00
Jonas Fonseca
15cd8c8d2c
Simplify dependency on doc-dirs by making MAKECMDGOALS depend on it
2006-01-08 22:33:26 +01:00
Russ Rowan
e15c9d4611
Minor code optimization.
2006-01-08 16:20:46 -05:00
Jonas Fonseca
905aa95a6e
Simplify some more
2006-01-08 21:57:55 +01:00
Russ Rowan
f451e89286
Merge with git+ssh://pasky.or.cz/srv/git/elinks.git
2006-01-08 15:54:29 -05:00
Russ Rowan
4fe54a9d68
Added another blank line between each block and one between each id:[*]::
...
line for readability.
2006-01-08 15:54:00 -05:00
Jonas Fonseca
877ed348be
Simplify the doc Makefile tremendously
2006-01-08 21:46:21 +01:00
Russ Rowan
97b0635d1e
Don't underline leading comment lines that contain ::.
2006-01-08 15:37:03 -05:00
Jonas Fonseca
3529b35da0
Sneak in an extra newline after section headers
2006-01-08 20:02:31 +01:00
Russ Rowan
33f373fbd5
Get rid of extraneous spaces left in the output. I have no idea if
...
asciidoc is sensitive enough to fail on these.
2006-01-08 13:05:11 -05:00
Russ Rowan
92be45d1be
Don't remove all blank lines. Just the first of a comment block.
2006-01-08 12:56:15 -05:00
Russ Rowan
67a89e1454
Added a document helper script: code2doc. It's ugly and mean, but it gets
...
the job done.
2006-01-08 05:15:08 -05:00
Jonas Fonseca
7d4b2ee5ed
Do a much needed update of the man pages
2006-01-03 15:18:49 +01:00
Jonas Fonseca
e2a79aeacb
Fix parsing by filtering the header outputed by ELinks
...
Also improve matching of option 'titles'.
2006-01-03 15:17:23 +01:00
Jonas Fonseca
0a844e6534
Drop useless comment block now that CVS Id tags are gone
...
... also drop comment about hacking.txt being extended gradually. AsciiDoc
burps on it and it really is kind of a boot message.
2006-01-03 14:28:26 +01:00
Jonas Fonseca
748bab64a7
Make the printed install paths simpler for man5 files when srcdir == builddir
2005-12-30 00:49:01 +01:00