aniani/elinks
1
0
Fork 0
mirror of https://github.com/rkd77/elinks.git synced 2024-12-04 14:46:47 -05:00
Code
a7397ea328
elinks/doc/Makefile

193 lines
4.4 KiB
Makefile
Raw Normal View History

path_to_top -> top_builddir
2005-10-19 22:00:35 -04:00
top_builddir=..
include $(top_builddir)/Makefile.config
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
SUBDIRS = man
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
VPATH = $(builddir):$(srcdir):$(top_srcdir)/contrib/perl
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
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
#export PATH="tools:$(PATH)"
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
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
# TODO: perl.pod should be pod2ized during make install. --pasky
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
### Script Dependencies
#
ELINKS = $(top_builddir)/src/elinks
FEATURES = $(top_srcdir)/features.conf
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
KBDBIND = $(top_srcdir)/src/config/kbdbind.c
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
Enforce locales env vars to be sure elinks generate english texts, even on systems using non-english locales.
2006-01-09 17:51:29 -05:00
### Locale env vars to override system one to ensure commands
# using elinks binary will generate texts in english
#
LOCALES = LC_ALL=C LANGUAGE=en
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
### Scripts
#
First attempt to build html/api docs It only does src/dom/sgml/parser.h for now.
2006-01-08 17:44:59 -05:00
CODE2DOC = $(top_srcdir)/doc/tools/code2doc
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
HELP2DOC = $(top_srcdir)/doc/tools/help2doc
IMPORT_FEATURES_CONF = $(top_srcdir)/doc/tools/import-features.conf
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
TXT_DOCS = \
bookmarks.txt \
ecmascript.txt \
elinks.1.txt \
elinkskeys.5.txt \
exmode.txt \
faq.txt \
installation.txt \
introduction.txt \
lua-scripting.txt \
mailcap.txt \
manual.txt \
marks.txt \
mime.txt \
remote.txt \
small.txt \
tabs.txt \
terminals.txt \
urlshortcuts.txt
GEN_TXT_DOCS = \
import-features.conf.txt \
Make elinks.conf(5) also be build from .txt files This simplifies help2doc since it now just have to do one single thing with output of either --config-help or --long-help. The new manpage is not as fancy wrt. indentation and sub titles but it is more uniform and we get a HTML version. Generate options-{config,command}.txt with help2doc. Only conditionally check for API header files, to speed up execusion.
2006-01-12 02:33:50 -05:00
option-command.txt \
option-config.txt \
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
keymap-defaults.txt \
keymap-actions.txt
TXT_DOCS += $(GEN_TXT_DOCS)
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
Simplify the doc Makefile tremendously
2006-01-08 15:46:21 -05:00
HTML_DOCS-$(CONFIG_ASCIIDOC) += \
Simplify some more
2006-01-08 15:57:55 -05:00
elinks.1.html \
Make elinks.conf(5) also be build from .txt files This simplifies help2doc since it now just have to do one single thing with output of either --config-help or --long-help. The new manpage is not as fancy wrt. indentation and sub titles but it is more uniform and we get a HTML version. Generate options-{config,command}.txt with help2doc. Only conditionally check for API header files, to speed up execusion.
2006-01-12 02:33:50 -05:00
elinks.conf.5.html \
Simplify some more
2006-01-08 15:57:55 -05:00
elinkskeys.5.html \
hacking.html \
manual.html
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
Simplify the doc Makefile tremendously
2006-01-08 15:46:21 -05:00
HTML_DOCS-$(CONFIG_XMLTO) += \
Simplify some more
2006-01-08 15:57:55 -05:00
manual.html-chunked
HTML_DOCS-$(CONFIG_POD2HTML) += \
perl.html \
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
perl-hooks.html \
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
Simplify the doc Makefile tremendously
2006-01-08 15:46:21 -05:00
MAN_DOCS-$(CONFIG_XMLTO) += \
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
elinks.1 \
Make elinks.conf(5) also be build from .txt files This simplifies help2doc since it now just have to do one single thing with output of either --config-help or --long-help. The new manpage is not as fancy wrt. indentation and sub titles but it is more uniform and we get a HTML version. Generate options-{config,command}.txt with help2doc. Only conditionally check for API header files, to speed up execusion.
2006-01-12 02:33:50 -05:00
elinks.conf.5 \
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
elinkskeys.5
Converted doc/ to ELBuild
2005-09-15 22:38:48 -04:00
Make elinks.conf(5) also be build from .txt files This simplifies help2doc since it now just have to do one single thing with output of either --config-help or --long-help. The new manpage is not as fancy wrt. indentation and sub titles but it is more uniform and we get a HTML version. Generate options-{config,command}.txt with help2doc. Only conditionally check for API header files, to speed up execusion.
2006-01-12 02:33:50 -05:00
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
# Only jw is used for generating PDF.
Simplify the doc Makefile tremendously
2006-01-08 15:46:21 -05:00
PDF_DOCS-$(CONFIG_JW) += \
Simplify some more
2006-01-08 15:57:55 -05:00
manual.pdf
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
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
## API Docs
#
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
Make elinks.conf(5) also be build from .txt files This simplifies help2doc since it now just have to do one single thing with output of either --config-help or --long-help. The new manpage is not as fancy wrt. indentation and sub titles but it is more uniform and we get a HTML version. Generate options-{config,command}.txt with help2doc. Only conditionally check for API header files, to speed up execusion.
2006-01-12 02:33:50 -05:00
ifneq ($(findstring api,$(MAKECMDGOALS)),)
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
API = $(shell find $(top_srcdir)/src/ -name '*.h' -exec grep -q 'API Doc' \{\} \; -printf "%p " | sort)
Make elinks.conf(5) also be build from .txt files This simplifies help2doc since it now just have to do one single thing with output of either --config-help or --long-help. The new manpage is not as fancy wrt. indentation and sub titles but it is more uniform and we get a HTML version. Generate options-{config,command}.txt with help2doc. Only conditionally check for API header files, to speed up execusion.
2006-01-12 02:33:50 -05:00
endif
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
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
define api_doc
api/$(2).txt: $(1)
@$(CODE2DOC) $(1) > $$@
API_TXT += api/$(2).txt
endef
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
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
$(foreach api,$(API),$(eval $(call api_doc,$(api),$(shell sed -n 's/.*API Doc\s*::\s*\([^ ]*\).*/\1/p' < $(api)),)))
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
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
## Se the default doc rules
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
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_DOCS = elinks.conf.5 $(MAN_DOCS-yes)
HTML_DOCS = $(HTML_DOCS-yes)
PDF_DOCS = $(PDF_DOCS-yes)
API_DOCS = $(patsubst %.txt,%.html,$(API_TXT))
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
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
api-dir:
@test -d api || $(MKINSTALLDIRS) api
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
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
txt: $(addprefix $(srcdir),$(TXT_DOCS))
html: txt $(HTML_DOCS)
pdf: txt $(PDF_DOCS)
Various minor improvements
2006-01-12 04:29:05 -05:00
man: txt $(MAN_DOCS)
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
api: api-dir $(API_DOCS)
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
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
all-docs: man html pdf
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
Various minor improvements
2006-01-12 04:29:05 -05:00
update-man: man
$(call cmd,installdata,$(srcdir)elinks.1,man/man1/elinks.1.in)
$(call cmd,installdata,$(srcdir)elinkskeys.5,man/man5/)
$(call cmd,installdata,$(srcdir)elinks.conf.5,man/man5/)
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
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
clean-local:
@$(RM) -r api $(GEN_TXT_DOCS) $(MAN_DOCS) $(HTML_DOCS) $(PDF_DOCS) *.tmp
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
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
# Autogenerated files.
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
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
# FIXME: Keep generated .txt files relative to the source directory and files
# they are included in.
Various minor improvements
2006-01-12 04:29:05 -05:00
quiet_cmd_help2doc = ' [$(LINK_COLOR)HELP2DOC$(END_COLOR)] $(RELPATH)$@'
cmd_help2doc = $(LOCALES) $(HELP2DOC) $(ELINKS) $@ > $@
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
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
import-features.conf.txt: $(FEATURES) $(IMPORT_FEATURES_CONF)
$(IMPORT_FEATURES_CONF) > $@
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
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
keymap-defaults.txt keymap-actions.txt: $(MAKE_ELINKSKEYS_MANPAGE) $(KBDBIND)
$(LOCALES) $(srcdir)tools/make-elinkskeys-manpage $(KBDBIND)
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
Make elinks.conf(5) also be build from .txt files This simplifies help2doc since it now just have to do one single thing with output of either --config-help or --long-help. The new manpage is not as fancy wrt. indentation and sub titles but it is more uniform and we get a HTML version. Generate options-{config,command}.txt with help2doc. Only conditionally check for API header files, to speed up execusion.
2006-01-12 02:33:50 -05:00
option-%.txt: $(ELINKS) $(HELP2DOC)
Various minor improvements
2006-01-12 04:29:05 -05:00
$(call cmd,help2doc)
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
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
## Default build rules
#
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
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
quiet_cmd_asciidoc = ' [$(LINK_COLOR)ASCIIDOC$(END_COLOR)] $(RELPATH)$@'
cmd_asciidoc = $(ASCIIDOC) -f asciidoc.conf -b $(2) -d $(call doctype,$<) -o $@ $<
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
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
quiet_cmd_xmlto = ' [$(LINK_COLOR)XMLTO$(END_COLOR)] $(RELPATH)$@'
cmd_xmlto = $(XMLTO) $(3) $(2) $<
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
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
quiet_cmd_jw = ' [$(LINK_COLOR)JW$(END_COLOR)] $(RELPATH)$@'
cmd_jw = $(JW) -b $(2) $<
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
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
quiet_cmd_pod2html = ' [$(LINK_COLOR)POD2HTML$(END_COLOR)] $(RELPATH)$@'
cmd_pod2html = $(POD2HTML) --outfile=$@ < $<
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
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
doctype = $(if $(findstring .1.,$(1)),manpage,$(if $(findstring .5.,$(1)),manpage,book))
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
Various minor improvements
2006-01-12 04:29:05 -05:00
MAN_DATE = $(shell date -I)
man_desc = `sed -n 's/:Description:\s*\(.*\)/\1/p' < $(subst .xml,.txt,$<)`
man_hack = sed "s/^\(\.TH \"ELINKS[^\"]*\" [0-9] \).*/\1\"$(1)\" \"$(MAN_DATE)\" \"$(1)\"/" < $@ | \
sed "s/@squote@/\\\\'/g" > $@.tmp && mv $@.tmp $@
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
%.html: %.txt asciidoc.conf
Don't masq calls
2006-01-11 05:12:03 -05:00
$(call cmd,asciidoc,xhtml11)
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
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
%.xml: %.txt asciidoc.conf
Don't masq calls
2006-01-11 05:12:03 -05:00
$(call cmd,asciidoc,docbook)
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
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
%.1: %.1.xml
Don't masq calls
2006-01-11 05:12:03 -05:00
$(call cmd,xmlto,man)
Various minor improvements
2006-01-12 04:29:05 -05:00
$(call man_hack,$(call man_desc))
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
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
%.5: %.5.xml
Don't masq calls
2006-01-11 05:12:03 -05:00
$(call cmd,xmlto,man)
Various minor improvements
2006-01-12 04:29:05 -05:00
$(call man_hack,$(call man_desc))
Initial commit of the HEAD branch of the ELinks CVS repository, as of Thu Sep 15 15:57:07 CEST 2005. The previous history can be added to this by grafting.
2005-09-15 09:58:31 -04:00
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
%.html-chunked: %.xml
Don't masq calls
2006-01-11 05:12:03 -05:00
$(call cmd,xmlto,html,-o $@)
Converted doc/ to ELBuild
2005-09-15 22:38:48 -04:00
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
%.pdf: %.xml
Don't masq calls
2006-01-11 05:12:03 -05:00
$(call cmd,jw,pdf)
First attempt to build html/api docs It only does src/dom/sgml/parser.h for now.
2006-01-08 17:44:59 -05:00
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
%.html: %.pod
Don't masq calls
2006-01-11 05:12:03 -05:00
$(call cmd,pod2html)
Build a DOM api from the two doctised header files
2006-01-09 06:45:50 -05:00
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
perl-%.html: %.pl
Don't masq calls
2006-01-11 05:12:03 -05:00
$(call cmd,pod2html)
First attempt to build html/api docs It only does src/dom/sgml/parser.h for now.
2006-01-08 17:44:59 -05:00
Include $(top_srcdir)/Makefile.lib instead of $(path_to_top)/Makefile.lib A step towards out of tree builds ...
2005-10-19 19:11:47 -04:00
include $(top_srcdir)/Makefile.lib
Copy Permalink