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 05:02:43 -05:00
|
|
|
# AsciiDoc configuration file
|
|
|
|
# Copyright (c) Jonas Fonseca <fonseca@diku.dk>, 2006
|
|
|
|
|
2006-01-11 21:15:30 -05:00
|
|
|
# This file sets the following ELinks specific AsciiDoc macros:
|
|
|
|
#
|
|
|
|
# General purpose:
|
|
|
|
# - man:page[section]: which is used for linking between ELinks manpages.
|
|
|
|
|
2006-01-14 13:47:47 -05:00
|
|
|
[replacements]
|
|
|
|
(^|[^-])--($|[^-])=\1--\2
|
|
|
|
|
2006-01-11 21:15:30 -05:00
|
|
|
# Some macros can have optional {0} value, that is what
|
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 05:02:43 -05:00
|
|
|
# the {0%...} and {0#...} handles.
|
|
|
|
|
|
|
|
#############################################################################
|
|
|
|
# DocBook
|
|
|
|
|
|
|
|
ifdef::backend-docbook[]
|
2006-01-11 21:15:30 -05:00
|
|
|
|
2006-01-12 04:48:48 -05:00
|
|
|
# To be replaced later
|
|
|
|
[attributes]
|
|
|
|
squote=@squote@
|
|
|
|
|
2006-01-11 21:15:30 -05:00
|
|
|
# No interlinking between elinks manpages
|
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 05:02:43 -05:00
|
|
|
[man-inlinemacro]
|
2006-01-12 01:32:25 -05:00
|
|
|
{0%{target}}
|
|
|
|
{0#<citerefentry>}
|
|
|
|
{0#<refentrytitle>{target}</refentrytitle><manvolnum>{0}</manvolnum>}
|
|
|
|
{0#</citerefentry>}
|
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 05:02:43 -05:00
|
|
|
|
2006-01-11 21:15:30 -05:00
|
|
|
# For manpages use less verbose linking
|
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 05:02:43 -05:00
|
|
|
ifdef::doctype-manpage[]
|
|
|
|
[link-inlinemacro]
|
|
|
|
{0%<{target}>}
|
|
|
|
{0#{0} <{target}>}
|
|
|
|
|
|
|
|
[http-inlinemacro]
|
|
|
|
{0%<http:{target}>}
|
|
|
|
{0#{0} <http:{target}>}
|
|
|
|
|
|
|
|
[mailto-inlinemacro]
|
|
|
|
<{target}>
|
|
|
|
|
|
|
|
endif::doctype-manpage[]
|
|
|
|
endif::backend-docbook[]
|
|
|
|
|
|
|
|
#############################################################################
|
|
|
|
# XHTML11
|
|
|
|
|
|
|
|
ifdef::backend-xhtml11[]
|
2006-01-11 21:15:30 -05:00
|
|
|
|
2006-01-12 04:48:48 -05:00
|
|
|
[attributes]
|
|
|
|
squote='
|
|
|
|
|
2006-01-11 21:15:30 -05:00
|
|
|
# Use the man:[] macro to link between elinks manpages
|
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 05:02:43 -05:00
|
|
|
[man-inlinemacro]
|
2006-01-12 05:34:56 -05:00
|
|
|
{eval:re.match("elinks", "{target}") != None}<a href="{target}.{0}.html">{target}({0})</a>
|
|
|
|
{eval:re.match("elinks", "{target}") == None}<b>{target}({0})</b>
|
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 05:02:43 -05:00
|
|
|
|
|
|
|
endif::backend-xhtml11[]
|