CVS log for doc/share/mk/doc.docbook.mk

Request diff between arbitrary revisions

Default branch: MAIN

Revision 1.131 / (download) - annotate - [select for diffs], Tue Jan 31 02:01:32 2012 UTC (9 days, 4 hours ago) by hrs
Branch: MAIN
CVS Tags: HEAD
Changes since 1.130: +3 -0 lines
Diff to previous 1.130 (colored)

- Fix ($user-html-header$) to support <script src="foo">.  While the rendered
  result of <script> end tag by the DSSSL stylesheet was </script\n> to avoid
  unnecessary spaces after the tag, most of the www browsers and HTML
  processors cannot recognize it as the end of <script>.  To workaround this,
  ($user-html-headers$) now outputs the start and the end tag independently
  in each single line.

- Add %html-header-script% to control if <script> is included in <head>.

- Add html.header.script.google knob for SGML and XML documents in non-DocBook
  DTD.  %html.header.script.google; and $html.header.script.google.

- Add WWWFREEBSDORG make(1) knob to control the <script> inclusion.  Note that
  <script> is disabled temporarily.

Discussed with:	gjb and core
Tested by:	gjb

Revision 1.130 / (download) - annotate - [select for diffs], Sun Jan 29 07:25:49 2012 UTC (10 days, 22 hours ago) by wblock
Branch: MAIN
Changes since 1.129: +2 -0 lines
Diff to previous 1.129 (colored)

Add a workaround to prevent Tidy from converting tabs to spaces
by converting them to &#09; before Tidy gets them.  Then Tidy
converts them back to real tabs, not spaces.

Reviewed by:	hrs, gjb

Revision 1.129 / (download) - annotate - [select for diffs], Sun May 15 20:41:31 2011 UTC (8 months, 3 weeks ago) by uqs
Branch: MAIN
CVS Tags: RELEASE_9_0_0
Changes since 1.128: +5 -5 lines
Diff to previous 1.128 (colored)

Typo and spelling fixes.

Revision 1.128 / (download) - annotate - [select for diffs], Sat Jun 24 12:20:45 2006 UTC (5 years, 7 months ago) by vanilla
Branch: MAIN
CVS Tags: RELEASE_8_2_0, RELEASE_8_1_0, RELEASE_8_0_0, RELEASE_7_4_0, RELEASE_7_3_0, RELEASE_7_2_0, RELEASE_7_1_0, RELEASE_7_0_0, RELEASE_6_4_0, RELEASE_6_3_0, RELEASE_6_2_0
Changes since 1.127: +1 -1 lines
Diff to previous 1.127 (colored)

Make Traditional Chinese PDF/PostScript of FreeBSD Documents

PR:		docs/99260
Submitted by:	    Intron <intron@intron.at.ac>

Revision 1.127 / (download) - annotate - [select for diffs], Wed Jun 21 15:26:28 2006 UTC (5 years, 7 months ago) by delphij
Branch: MAIN
Changes since 1.126: +1 -1 lines
Diff to previous 1.126 (colored)

Since we can now generate txt files with html2text, remove zh_CN.GB2312
from the NO_PLAINTEXT_LANG list.

Spotted by:	intron at intron dot ac

Revision 1.126 / (download) - annotate - [select for diffs], Mon Apr 17 17:50:34 2006 UTC (5 years, 9 months ago) by hrs
Branch: MAIN
CVS Tags: RELEASE_6_1_0, RELEASE_5_5_0
Changes since 1.125: +78 -13 lines
Diff to previous 1.125 (colored)

- Move build targets for book.{ps,pdf} of the handbook to the LI part.
- Add NO_{TEX,PLAINTEXT,RTF} and NO_{TEX,PLAINTEXT,RTF}_LANG knobs not to
  build or install broken files[*].

Suggested by:	alex.istra at rambler dot ru[*]

Revision 1.125 / (download) - annotate - [select for diffs], Fri Apr 7 14:34:34 2006 UTC (5 years, 10 months ago) by hrs
Branch: MAIN
Changes since 1.124: +11 -9 lines
Diff to previous 1.124 (colored)

Add JADETEX_PREPROCESS and PDFTEX_PREPROCESS for pre-processing
TeX file.

Revision 1.124 / (download) - annotate - [select for diffs], Wed Mar 22 14:50:30 2006 UTC (5 years, 10 months ago) by delphij
Branch: MAIN
Changes since 1.123: +31 -26 lines
Diff to previous 1.123 (colored)

Apply RTF fixups which improves our .rtf generation:
 - Tell the location where Jade/OpenJade will look for the PNG
   images.
 - Use rtf-nopng as extension name for Jade/OpenJade generated
   RTF files.
 - Use fixrtf(1) from textproc/fixrtf to make necessary fixups
   on generated RTFs, embedding PNGs into the intermediate RTF
   and save them into the new *.rtf files.
 - Retire rtf.tar target which is no longer necessary.

Please note that you have to upgrade the docproj toolset or
this commit would break the build.

PR:		docs/93965
Submitted by:	intron <intron intron ac>
Approved by:	doceng

Revision 1.123 / (download) - annotate - [select for diffs], Tue Dec 13 08:03:57 2005 UTC (6 years, 1 month ago) by delphij
Branch: MAIN
Changes since 1.122: +29 -17 lines
Diff to previous 1.122 (colored)

Improve the docbook build infrastructure's index.sgml build process:

 - Consider index.sgml as intermediate file, not dependency that ${DOC}.*
   require.  Instead, generate it on-the-fly when building ${DOC}.*.
   This solves the problem that index.sgml is generated for the first
   built target, but needs to be different from target to target.

   The affected targets are:
	index.html HTML.manifest
	${DOC}.html
	${DOC}.html-text
	${DOC}.rtf
	${DOC}.tex
	${DOC}.tex-pdf

   ${INDEX_SGML} target removed in favor of the on-the-fly build.

 - When building ${DOC}.rtf, add ${PRINT_INDEX} and ${LOCAL_IMAGES_PNG}
   as dependencies, eliminating the need of building ${DOC}.rtf without
   having to build ${DOC}.html beforehand.

 - Modifications against ${HTML_INDEX} and ${HTML_SPLIT_INDEX}:
	+ Add dependency to ${SRCS} and ${LOCAL_IMAGES_TXT} to force
	  index updates when necessary.
	+ Every build now causes index.sgml to be reinitialized.
	+ Depend on ${DOC}.* to generate index.sgml.

Submitted by:	"intron" <intron at intron ac>
PR:		docs/90255 (slightly changed version)

Revision 1.122 / (download) - annotate - [select for diffs], Sat Dec 10 14:02:03 2005 UTC (6 years, 2 months ago) by delphij
Branch: MAIN
Changes since 1.121: +8 -2 lines
Diff to previous 1.121 (colored)

Merge some improvements of build infrastructure from the Simplified Chinese
project:
 - For "dvi" and "ps", add "${DOC}.out" to CLEANFILES
 - Allow overriding of the following targets:
   ${DOC}.txt, ${DOC}.dvi, ${DOC}.pdf, ${PRINT_INDEX}

Submitted by:	"intron" <intron intron ac>
PR:		docs/90171

Revision 1.121 / (download) - annotate - [select for diffs], Fri Sep 23 19:38:22 2005 UTC (6 years, 4 months ago) by hrs
Branch: MAIN
CVS Tags: RELEASE_6_0_0
Changes since 1.120: +24 -0 lines
Diff to previous 1.120 (colored)

Disable .ps and .pdf build of some languages---ja_JP.eucJP,
ru_RU.KOI8-R, and zh_TW.Big5---because they are broken.
This behavior can be controlled by using $NO_TEX_LANG.

This is a temporary measure, and we need to use localized
TeX variants to build the printable formats.

Tested by:	simon

Revision 1.120 / (download) - annotate - [select for diffs], Tue Aug 30 19:32:46 2005 UTC (6 years, 5 months ago) by pav
Branch: MAIN
Changes since 1.119: +7 -11 lines
Diff to previous 1.119 (colored)

- Rework jade/openjade handling.

  Before: use jade on i386, openjade on !386, provide OPENJADE var for override

  Now: detect what's available, when both systems are present, use jade,
  provide OPENJADE var for override

  This change follows same logic as recent similar change in web.mk

Approved by:	keramida (mentor)

Revision 1.119 / (download) - annotate - [select for diffs], Mon Jan 10 22:00:58 2005 UTC (7 years ago) by keramida
Branch: MAIN
CVS Tags: RELEASE_5_4_0, RELEASE_4_11_0
Changes since 1.118: +1 -1 lines
Diff to previous 1.118 (colored)

Set the default line width for FORMATS="txt" to 72 columns.  This fixes,
after a very long time, the problem described in:

PR:		docs/41791
Submitted by:	Jerry Dunham <jdunham@m3designinc.com>

Revision 1.118 / (download) - annotate - [select for diffs], Thu Jan 6 12:40:46 2005 UTC (7 years, 1 month ago) by simon
Branch: MAIN
Changes since 1.117: +3 -3 lines
Diff to previous 1.117 (colored)

Tell collateindex to set the id tag (to "doc-index" in lack of better
idea for a name) so we will not get dynamic filenames for html-split
output.

Revision 1.117 / (download) - annotate - [select for diffs], Thu Sep 2 17:12:14 2004 UTC (7 years, 5 months ago) by murray
Branch: MAIN
CVS Tags: RELEASE_5_3_0
Changes since 1.116: +0 -5 lines
Diff to previous 1.116 (colored)

Add support for building documents in our doc/ tree marked up in
Norman Walsh's DocBook Slides DTD.

This DTD offers the vocabulary of simplified DocBook for
presentations.  Initially, the supported output formats are PDF and
HTML.

XSL stylesheets are used so libxslt is required.

PassiveTeX is used for the PDF generation to convert the XSL-FO
directly to PDF.

This commit moves various TeX definitions out of doc.docbook.mk and
into doc.project.mk, since docbook is no longer the only back-end to
utilize TeX.

An example Makefile would look like :

----
DOCFORMAT=	slides
DOC=		slides

SRCS=	slides.xml

DOC_PREFIX?=	${.CURDIR}/../../..
.include "${DOC_PREFIX}/share/mk/doc.project.mk"
---

And an example slides file (slides.xml) looks like :

---
<!DOCTYPE slides PUBLIC "-//Norman Walsh//DTD Slides XML V3.3.1//EN"
  "http://docbook.sourceforge.net/releases/slides/3.3.1/slides.dtd">
<slides>
<slidesinfo>
  <title>What's new in FreeBSD 5.3</title>
  <titleabbrev>FreeBSD 5.3</titleabbrev>
</slidesinfo>

<foil><title>Introduction Slide</title>
  <para>Content</para>
</foil>
</slides>
---

You could then build the HTML and PDF versions of the slides by typing
"make FORMATS='pdf html'".  Enjoy.

Please coordinate with doceng@ before importing any presentations to
doc/.

Revision 1.116 / (download) - annotate - [select for diffs], Thu Sep 2 16:42:01 2004 UTC (7 years, 5 months ago) by murray
Branch: MAIN
Changes since 1.115: +0 -2 lines
Diff to previous 1.115 (colored)

XSLTPROC and TIDY are not specific to either DocBook or HTML formats,
so move the associated variables to doc.project.mk instead of
duplicating the definitions for each doc type.

Revision 1.115 / (download) - annotate - [select for diffs], Thu Aug 12 15:09:05 2004 UTC (7 years, 5 months ago) by blackend
Branch: MAIN
CVS Tags: ISBN_1-57176-328-7
Changes since 1.114: +22 -2 lines
Diff to previous 1.114 (colored)

Fix the RTF build:

Jade is not able to embed images but links them instead, so images have
to be installed with the .rtf document (it's similar to the HTML case).

I added a new format: rtf.tar which is a better solution than using rtf
since the images are not embedded.
make FORMATS=rtf.tar is your friend :)

Revision 1.114 / (download) - annotate - [select for diffs], Thu Aug 12 05:28:42 2004 UTC (7 years, 5 months ago) by murray
Branch: MAIN
Changes since 1.113: +1 -1 lines
Diff to previous 1.113 (colored)

Backout last change.  It was already included in doc.common.mk.

Found by:	hrs

Revision 1.113 / (download) - annotate - [select for diffs], Thu Aug 12 03:45:39 2004 UTC (7 years, 5 months ago) by murray
Branch: MAIN
Changes since 1.112: +1 -1 lines
Diff to previous 1.112 (colored)

Always use absolute URLs for print output.

Revision 1.112 / (download) - annotate - [select for diffs], Wed Aug 11 10:51:13 2004 UTC (7 years, 6 months ago) by murray
Branch: MAIN
Changes since 1.111: +2 -1 lines
Diff to previous 1.111 (colored)

Honor DVIPSFLAGS even if PAPERSIZE is not defined.

Revision 1.111 / (download) - annotate - [select for diffs], Mon Aug 9 16:22:55 2004 UTC (7 years, 6 months ago) by hrs
Branch: MAIN
Changes since 1.110: +4 -12 lines
Diff to previous 1.110 (colored)

- When <langcode>/share/mk/doc.local.mk exists, it will be included
  just after doc.common.mk included.  This can be used for various
  language specific customizations.

- Remove SP_ENCODING_LIST.  Translators should define the SP_ENCODING
  variable directly in their doc.local.mk when it is needed.

Discussed with:	den

Revision 1.110 / (download) - annotate - [select for diffs], Fri Aug 6 09:33:17 2004 UTC (7 years, 6 months ago) by den
Branch: MAIN
Changes since 1.109: +3 -2 lines
Diff to previous 1.109 (colored)

Parse ISO* encodings, convert it to ISO-* before SP_ENCODINGS assignment

Add ISO-8859-2 to SP_ENCODING_LIST

Revision 1.109 / (download) - annotate - [select for diffs], Fri Aug 6 05:22:17 2004 UTC (7 years, 6 months ago) by den
Branch: MAIN
Changes since 1.108: +23 -8 lines
Diff to previous 1.108 (colored)

Set SP_ENCODING from SP_ENCODING_LIST

Add KOI8-R to this list
Other encodings can be added after some testing

Note: KOI8-R supported by jade-1.2.1_8 and above

Reviewed by:		Dmitry Morozovsky <marck@rinet.ru>, ru
With cleanups from:	ru
No objections from:	freebsd-doc

Revision 1.108 / (download) - annotate - [select for diffs], Wed Jul 14 05:28:11 2004 UTC (7 years, 6 months ago) by murray
Branch: MAIN
Changes since 1.107: +10 -0 lines
Diff to previous 1.107 (colored)

Add a DSSSL stylsheet to enable more efficient spellchecking.  This
stylesheet omits the contents of <filename>, <devicename>,
<programlisting>, and other tags that are likely to not contain real
English words.  The output of this stylesheet can then be checked with
'make spellcheck' with far fewer false positives.

Revision 1.107 / (download) - annotate - [select for diffs], Wed Jul 7 13:30:49 2004 UTC (7 years, 7 months ago) by hrs
Branch: MAIN
Changes since 1.106: +1 -1 lines
Diff to previous 1.106 (colored)

Fix the lint target to use ${NSGMLSFLAGS}.

Revision 1.106 / (download) - annotate - [select for diffs], Wed May 12 12:58:12 2004 UTC (7 years, 8 months ago) by hrs
Branch: MAIN
Changes since 1.105: +7 -2 lines
Diff to previous 1.105 (colored)

Use URLS_ABSOLUTE=yes for non-html formats and during
"make package".

Suggested by:	den

Revision 1.105 / (download) - annotate - [select for diffs], Mon Apr 5 22:53:43 2004 UTC (7 years, 10 months ago) by simon
Branch: MAIN
CVS Tags: RELEASE_4_10_0
Changes since 1.104: +1 -1 lines
Diff to previous 1.104 (colored)

Really unbreak creation of PDF documents which use "shared" PNG images:

The previous fix only worked in some cases, so back it out and add a
more clean fix.  This fix also makes "make clean" work as expected again
for the shared PNG images.

The real problem is the assumption in doc.images.mk that the
${IMAGES_PDF} variable only need to contain images converted to PDF
format and not images which are already in PNG format.  We need to list
the PNG images in ${IMAGES_PDF} since they might be in a shared image
directory, and if we don't list them in ${IMAGES_PDF} they will not be
copied to the working directory and will therefor not be found during
build.

Prompted by:	phantom

Revision 1.104 / (download) - annotate - [select for diffs], Wed Mar 24 22:57:56 2004 UTC (7 years, 10 months ago) by simon
Branch: MAIN
Changes since 1.103: +1 -1 lines
Diff to previous 1.103 (colored)

Unbreak creation of PDF documents which use PNG images (e.g.
articles/console-server), by also copying PNG images to the working
directory during PDF build.

Revision 1.103 / (download) - annotate - [select for diffs], Wed Mar 24 09:52:57 2004 UTC (7 years, 10 months ago) by phantom
Branch: MAIN
Changes since 1.102: +1 -1 lines
Diff to previous 1.102 (colored)

We never used .docb suffix in the project tree, so do not mention it
in comments.

Revision 1.102 / (download) - annotate - [select for diffs], Wed Mar 24 09:50:03 2004 UTC (7 years, 10 months ago) by phantom
Branch: MAIN
Changes since 1.101: +15 -2 lines
Diff to previous 1.101 (colored)

Introduce BZIP2_PACKAGE user defined variable which used to control
output format of 'make package'.  If BZIP2_PACKAGE is set, then .tbz
archive will be generated instead of .tgz.

Revision 1.101 / (download) - annotate - [select for diffs], Wed Mar 24 09:45:31 2004 UTC (7 years, 10 months ago) by phantom
Branch: MAIN
Changes since 1.100: +13 -20 lines
Diff to previous 1.100 (colored)

Fix 'make package' to generate valid packages

After introduction of shared images concept it was not possible to realize
how images should be put into packages, so built images references were
used.  It result up tgz file with lots filename which contained of '..'.

In order to workaround this issue I used temporary directory to install
complete packaging document, then generate PLIST based on content of
temporary directory and create actual package then.

Prodded by:	The FreeBSD Russian Documentation Project

Revision 1.100 / (download) - annotate - [select for diffs], Tue Mar 23 23:53:27 2004 UTC (7 years, 10 months ago) by phantom
Branch: MAIN
Changes since 1.99: +7 -0 lines
Diff to previous 1.99 (colored)

Unconditionally set 'NO_SUBDIR' define.

doc.docbook.mk includes bsd.subdir.mk via bsd.obj.mk which is responsible
for processing of 'SUBDIR' make variable.  But since we are handling
'SUBDIR' here explicitly, doing same thing (second time!) via
bsd.subdir.mk's rules makes no sense and only adds disk IO overhead.

It reduces install recursive calls by factor 4.

Revision 1.99 / (download) - annotate - [select for diffs], Mon Feb 16 14:13:24 2004 UTC (7 years, 11 months ago) by hrs
Branch: MAIN
Changes since 1.98: +14 -14 lines
Diff to previous 1.98 (colored)

Use FOO_CMD instead of FOO to avoid a conflict with a variable used
in the docproj port.  TEX, LATEX, PDFTEX, JADETEX, and PDFJADETEX
has been renamed to TEX_CMD, LATEX_CMD, PDFTEX_CMD, JADETEX_CMD, and
PDFJADETEX_CMD for consistency.  And TEXCMDS has been renamed
TEX_CMDSEQ because TEXCMDS and TEX_CMD are misleading names.

Discussed on:	-doc

Revision 1.98 / (download) - annotate - [select for diffs], Sun Feb 8 12:34:16 2004 UTC (8 years ago) by hrs
Branch: MAIN
Changes since 1.97: +6 -0 lines
Diff to previous 1.97 (colored)

Install TRADEMARKS.html and LEGALNOTICE.html missing in HTML.manifest.

Revision 1.97 / (download) - annotate - [select for diffs], Wed Feb 4 16:47:22 2004 UTC (8 years ago) by hrs
Branch: MAIN
Changes since 1.96: +8 -6 lines
Diff to previous 1.96 (colored)

Add $JADETEX and $JADEPDFTEX.

Revision 1.96 / (download) - annotate - [select for diffs], Mon Dec 8 02:37:02 2003 UTC (8 years, 2 months ago) by murray
Branch: MAIN
CVS Tags: RELEASE_5_2_1, RELEASE_5_2_0
Changes since 1.95: +4 -0 lines
Diff to previous 1.95 (colored)

Add a 'GREYSCALE_IMAGES' option to the print infrastructure to convert
screenshots to greyscale before embedding them in the PostScript
output.

Sponsored by:	FreeBSD Mall, Inc.

Revision 1.95 / (download) - annotate - [select for diffs], Sun Nov 16 18:56:23 2003 UTC (8 years, 2 months ago) by hrs
Branch: MAIN
Changes since 1.94: +5 -3 lines
Diff to previous 1.94 (colored)

Move lists of FreeBSD mirror sites to doc/share/sgml/mirrors.xml
(currently en_US.ISO8859-1/books/handbook/mirrors and
www/en/index.xsl use it).

Reviewed by:	simon
Discussed on:	-doc

Revision 1.94 / (download) - annotate - [select for diffs], Thu Oct 2 19:46:49 2003 UTC (8 years, 4 months ago) by ceri
Branch: MAIN
CVS Tags: RELEASE_4_9_0
Changes since 1.93: +7 -1 lines
Diff to previous 1.93 (colored)

Add LEGALNOTICE.html and TRADEMARKS.html to CLEANFILES when appropriate.

Revision 1.93 / (download) - annotate - [select for diffs], Thu Sep 18 21:39:37 2003 UTC (8 years, 4 months ago) by simon
Branch: MAIN
Changes since 1.92: +1 -1 lines
Diff to previous 1.92 (colored)

Change the default Tidy options so it doesn't indent, and so it wraps
the lines at column 90, instead of the default 68.  This makes the
resulting HTML considerably smaller.

The change also band-aid a problem where Tidy wrap lines which shouldn't
have been wrapped.  This can cause extra spaces in the resulting HTML,
e.g. resulting in "( audio/lame)" instead of "(audio/lame)".

Discussed on:	-doc

Revision 1.92 / (download) - annotate - [select for diffs], Sun Sep 14 13:11:43 2003 UTC (8 years, 4 months ago) by simon
Branch: MAIN
Changes since 1.91: +4 -0 lines
Diff to previous 1.91 (colored)

Add support for optionally showing all trademark symbols, not just the
required symbols, by setting the make variable
WITH_ALL_TRADEMARK_SYMBOLS, to any non empty value.

This feature is mainly useful for document writers, to make sure all
trademarks are marked up correctly.

Revision 1.91 / (download) - annotate - [select for diffs], Wed Aug 27 07:10:36 2003 UTC (8 years, 5 months ago) by blackend
Branch: MAIN
Changes since 1.90: +2 -1 lines
Diff to previous 1.90 (colored)

Add more warnings to make lint.  It should be possible now to find
empty and unclosed tags.  I used the word "should" because sometimes it
does not work, however most of malformed tags are found now.
That idea came after a talk with Denis Peplin.

Revision 1.90 / (download) - annotate - [select for diffs], Sat Jul 5 10:09:50 2003 UTC (8 years, 7 months ago) by blackend
Branch: MAIN
Changes since 1.89: +8 -2 lines
Diff to previous 1.89 (colored)

Quick fix to produce correct html.tar and html.split.tar tarballs

PR:	docs/52419

Revision 1.89 / (download) - annotate - [select for diffs], Thu Jul 3 13:02:31 2003 UTC (8 years, 7 months ago) by hrs
Branch: MAIN
Changes since 1.88: +3 -1 lines
Diff to previous 1.88 (colored)

Add ${PREFIX}/share/sgml/catalog.ports into ${CATALOGS} explicitly.

Revision 1.88 / (download) - annotate - [select for diffs], Thu Jul 3 03:49:48 2003 UTC (8 years, 7 months ago) by kuriyama
Branch: MAIN
Changes since 1.87: +5 -4 lines
Diff to previous 1.87 (colored)

Collect catalogs only if avaiable.

In xmlcatmgr world, only ${PREFIX}/share/{sgml,xml}/catalog is
required from under ${PREFIX}.

Revision 1.87 / (download) - annotate - [select for diffs], Wed May 21 21:16:10 2003 UTC (8 years, 8 months ago) by trhodes
Branch: MAIN
CVS Tags: RELEASE_5_1_0
Changes since 1.86: +6 -0 lines
Diff to previous 1.86 (colored)

Quiet a few make warnings by adding a few .if statements.
bsd.obj.mk already includes bsd.subdir.mk so there is no need
to include it twice.

PR:		52540
Submitted by:	"Simon L.Nielsen" <simon@nitro.dk>
Tested with:	cd doc/ && make

Revision 1.86 / (download) - annotate - [select for diffs], Wed May 21 11:23:45 2003 UTC (8 years, 8 months ago) by ceri
Branch: MAIN
Changes since 1.85: +24 -1 lines
Diff to previous 1.85 (colored)

Slightly beef up the spellcheck target so that it works for the html-split
and txt formats as well as the html format.

Reviewed by:	murray

Revision 1.85 / (download) - annotate - [select for diffs], Sun May 4 04:59:43 2003 UTC (8 years, 9 months ago) by murray
Branch: MAIN
Changes since 1.84: +6 -0 lines
Diff to previous 1.84 (colored)

Add a simple script to locate areas of a DocBook file where
<indexterms> are sparse.  Also add makefile glue so that this may be
invoked on the Handbook or any other document in the FDP tree by
typing "make indexcheck".

Sponsored by:	FreeBSD Mall, Inc.

Revision 1.84 / (download) - annotate - [select for diffs], Sun May 4 04:51:09 2003 UTC (8 years, 9 months ago) by murray
Branch: MAIN
Changes since 1.83: +7 -0 lines
Diff to previous 1.83 (colored)

Add an ispell-based "spellcheck" target to the doc build
infrastructure.

Sponsored by:	FreeBSD Mall, Inc.

Revision 1.83 / (download) - annotate - [select for diffs], Tue Apr 22 18:35:42 2003 UTC (8 years, 9 months ago) by hrs
Branch: MAIN
Changes since 1.82: +2 -0 lines
Diff to previous 1.82 (colored)

Back out WITH_DOCFORMAT_NAVI_LINK?=YES in Makefile.  The navi-link
is generated when ${WITH_DOCFORMAT_NAVI_LINK} is defined or
${FORMATS} includes "html" and "html-split."

Revision 1.82 / (download) - annotate - [select for diffs], Sat Apr 19 11:39:30 2003 UTC (8 years, 9 months ago) by hrs
Branch: MAIN
Changes since 1.81: +3 -0 lines
Diff to previous 1.81 (colored)

- Add WITH_DOCFORMAT_NAVI_LINK to mk/doc.docbook.mk and
  enable it in en_US.ISO8859-1/ and ja_JP.eucJP/.

- Add PUBLIC "-//FreeBSD//ENTITIES DocBook Language Specific Entities//EN"
  and l10n.ent for entity localization.

- Use share/misc/docbook.css for indentiation of <programlisting>
  and <screen>.

- Add some missing $FreeBSD$.

Revision 1.81 / (download) - annotate - [select for diffs], Fri Apr 11 09:21:15 2003 UTC (8 years, 10 months ago) by blackend
Branch: MAIN
Changes since 1.80: +29 -10 lines
Diff to previous 1.80 (colored)

Commit images separation from en_US.ISO8859-1/ directory to
share/images.  To link "generic" images (share/images ones) from
Makefiles use IMAGES_EN and to link localized images use IMAGES.
For an example look at en_US.ISO8859-1/books/handbook/Makefile

Revision 1.80 / (download) - annotate - [select for diffs], Wed Apr 9 22:46:30 2003 UTC (8 years, 10 months ago) by ceri
Branch: MAIN
Changes since 1.79: +1 -1 lines
Diff to previous 1.79 (colored)

Now that the docproj port is updated accordingly, use version 4.2 of the
docbook-xml DTD when building with the xsl stylesheet.

Revision 1.79 / (download) - annotate - [select for diffs], Tue Apr 8 22:00:23 2003 UTC (8 years, 10 months ago) by ceri
Branch: MAIN
Changes since 1.78: +4 -0 lines
Diff to previous 1.78 (colored)

Clean up properly when STYLESHEET_TYPE is set to "xsl".

Reviewed by:	trhodes

Revision 1.78 / (download) - annotate - [select for diffs], Sun Feb 16 14:59:30 2003 UTC (8 years, 11 months ago) by hrs
Branch: MAIN
CVS Tags: RELEASE_4_8_0
Changes since 1.77: +12 -0 lines
Diff to previous 1.77 (colored)

Add the following knobs for the DocBook DSSSL stylesheets:

 - WITH_INLINE_LEGALNOTICE (for HTML only):
     do not render <legalnotice> as a separate file if defined.

 - WITH_ARTICLE_TOC:
     generate TOC for documents whose root element is <article> if defined.

 - WITH_BIBLIOXREF_TITLE:
     for cross references to bibliography entries, use the title of
     the entry as the cross reference text, if defined.

Revision 1.77 / (download) - annotate - [select for diffs], Sat Feb 1 15:14:40 2003 UTC (9 years ago) by blackend
Branch: MAIN
Changes since 1.76: +1 -1 lines
Diff to previous 1.76 (colored)

Add ${DOC}.ps in pdf target CLEANFILES, this is needed to correctly clean
the Handbook build in pdf format.

Revision 1.76 / (download) - annotate - [select for diffs], Sun Dec 29 13:01:16 2002 UTC (9 years, 1 month ago) by blackend
Branch: MAIN
CVS Tags: RELEASE_5_0_0
Changes since 1.75: +3 -2 lines
Diff to previous 1.75 (colored)

Add ${DOC}.tex to CLEANFILES list of ps and pdf formats.

Revision 1.75 / (download) - annotate - [select for diffs], Fri Dec 27 00:25:42 2002 UTC (9 years, 1 month ago) by trhodes
Branch: MAIN
Changes since 1.74: +1 -1 lines
Diff to previous 1.74 (colored)

Create XHTML documents in place of HTML4 documents with a small alteration
to the *.mk files.

Revision 1.74 / (download) - annotate - [select for diffs], Sat Dec 7 20:12:45 2002 UTC (9 years, 2 months ago) by blackend
Branch: MAIN
Changes since 1.73: +5 -3 lines
Diff to previous 1.73 (colored)

Add some ${LOCAL_IMAGES_TXT} where needed to allow the build of various
formats: rtf and pdf.

Problem found by:	ceri

Revision 1.73 / (download) - annotate - [select for diffs], Wed Nov 20 19:41:10 2002 UTC (9 years, 2 months ago) by ceri
Branch: MAIN
Changes since 1.72: +1 -1 lines
Diff to previous 1.72 (colored)

s/seperate/separate/

Revision 1.72 / (download) - annotate - [select for diffs], Sun Nov 10 14:39:46 2002 UTC (9 years, 3 months ago) by tmm
Branch: MAIN
Changes since 1.71: +1 -1 lines
Diff to previous 1.71 (colored)

Use openjade on all non-i386 platforms, not just alpha.

Reviewed by:	-doc

Revision 1.71 / (download) - annotate - [select for diffs], Sat Nov 2 21:34:57 2002 UTC (9 years, 3 months ago) by blackend
Branch: MAIN
Changes since 1.70: +2 -2 lines
Diff to previous 1.70 (colored)

Add ${LOCAL_IMAGES_TXT} variable where needed to allow the creation of
.txt images.

Submitted by:	nik

Revision 1.70 / (download) - annotate - [select for diffs], Mon Oct 28 19:44:08 2002 UTC (9 years, 3 months ago) by nik
Branch: MAIN
Changes since 1.69: +1 -1 lines
Diff to previous 1.69 (colored)

Add the ${LOCAL_IMAGES_TXT} variable as a dependency in the html-text
target, ensuring that any .txt files that need to be generated for the
document will be.

Revision 1.69 / (download) - annotate - [select for diffs], Sat Oct 12 10:53:51 2002 UTC (9 years, 4 months ago) by blackend
Branch: MAIN
Changes since 1.68: +6 -4 lines
Diff to previous 1.68 (colored)

Allow the use of graphic files from en_US.ISO8859-1/ directory for
localized docs.

For example in the Handbook Makefile, an image entry will be similar to:

IMAGES = ../../../en_US.ISO8859-1/books/handbook/install/userconfig.scr

the image will be built in that directory and then installed in the right
localized place at installation time.

Some versions of ghostscript (7.04) have problems with the use of
relative path when the arguments are passed by peps; a fix was
added.

Reviewed and discussed with:	murray

Revision 1.68 / (download) - annotate - [select for diffs], Tue Jun 4 11:40:17 2002 UTC (9 years, 8 months ago) by nik
Branch: MAIN
CVS Tags: RELEASE_4_7_0, RELEASE_4_6_2, RELEASE_4_6_1
Changes since 1.67: +49 -5 lines
Diff to previous 1.67 (colored)

Add support for generating {book,article}.xml from {book,article}.sgml.

Add support for using the XSL stylesheets to generate HTML output using
XSLT transforms, rather than using JadeTeX.  So (assuming you have
installed xsltproc from ports/textproc/libxslt, and the docbook-xsl
stylesheets), you can now do

    make STYLESHEET_TYPE=xsl FORMATS=html

and get HTML output that way.

Revision 1.67 / (download) - annotate - [select for diffs], Sun May 5 16:22:58 2002 UTC (9 years, 9 months ago) by nik
Branch: MAIN
CVS Tags: RELEASE_4_6_0
Changes since 1.66: +1 -1 lines
Diff to previous 1.66 (colored)

Use the project's default.xsl file in favour of the stylesheet default.

Revision 1.66 / (download) - annotate - [select for diffs], Sun May 5 16:06:19 2002 UTC (9 years, 9 months ago) by nik
Branch: MAIN
Changes since 1.65: +14 -0 lines
Diff to previous 1.65 (colored)

Add enough of a framework so that "make STYLESHEET_TYPE=xsl FORMATS=html"
now works.

For limited values of "works".  None of the FreeBSD extensions to the
DocBook DTD are currently recognised, for example.

Revision 1.65 / (download) - annotate - [select for diffs], Sun May 5 15:30:06 2002 UTC (9 years, 9 months ago) by nik
Branch: MAIN
Changes since 1.64: +3 -0 lines
Diff to previous 1.64 (colored)

Add a STYLESHEET_TYPE variable, which defaults to 'dsssl'.  When set to
'xsl' a different set of rules are invoked to use an XSL toolchain
(processors, stylesheets, and so forth) to convert the DocBook to the
various different output formats.

I haven't actually written the rules that are invoked when this knob is
set to 'xsl'.  But how hard can it be. . .

Revision 1.64 / (download) - annotate - [select for diffs], Mon Apr 22 08:59:03 2002 UTC (9 years, 9 months ago) by murray
Branch: MAIN
Changes since 1.63: +6 -0 lines
Diff to previous 1.63 (colored)

Add a new print-output build variable for the doc project, 'RLE'.

If defined, EPS files are run length encoded before being integrated
into the PostScript output.

  "make book.ps" currently generates a 96 megabyte file.
  "make RLE=1 book.ps" generates a 16 megabyte file.

If we added a tool to use better (LZW) compression for the eps
screenshots and such, then we could reduce this number further.

Revision 1.63 / (download) - annotate - [select for diffs], Fri Apr 12 18:13:37 2002 UTC (9 years, 10 months ago) by bmah
Branch: MAIN
Changes since 1.62: +4 -2 lines
Diff to previous 1.62 (colored)

MFP4 (change 8929):

	Don't make the assumption that source files are writable.
	The FDP infrastructure has a few constructs of the form
	"cp foo bar; cat baz >> bar".  This breaks if foo isn't
	writable (as is frequently the case in P4 work directory).

Revision 1.62 / (download) - annotate - [select for diffs], Mon Feb 25 14:24:51 2002 UTC (9 years, 11 months ago) by murray
Branch: MAIN
Changes since 1.61: +3 -0 lines
Diff to previous 1.61 (colored)

Netscape 4.X does not support the '@import' directive in CSS
stylesheets.  To get around this, append the filename specified in the
'CSS_SHEET_ADDITIONS' variable (if defined) to the end of the default
CSS stylesheet.  This allows us to add document-specific stylesheet
rules while still supporting braindead browsers and reusing the
default CSS code.

Revision 1.61 / (download) - annotate - [select for diffs], Wed Jan 2 01:10:37 2002 UTC (10 years, 1 month ago) by murray
Branch: MAIN
CVS Tags: RELEASE_4_5_0
Changes since 1.60: +1 -0 lines
Diff to previous 1.60 (colored)

Add command variables for PS2EPS, PIC2PS, and groff so that we can use
PIC diagrams in the doc tree.

Revision 1.60 / (download) - annotate - [select for diffs], Tue Jan 1 08:41:19 2002 UTC (10 years, 1 month ago) by murray
Branch: MAIN
Changes since 1.59: +3 -3 lines
Diff to previous 1.59 (colored)

Pass the TEXCMDS variable to pdftex when generating a PDF file, so
that optional features such as two-sided output and justification work
for PDF files, not just PostScript.

PR:		docs/32849
Submitted by:	Peter Johnson <freebsd@bilogic.org>

Revision 1.59 / (download) - annotate - [select for diffs], Tue Jan 1 05:30:49 2002 UTC (10 years, 1 month ago) by murray
Branch: MAIN
Changes since 1.58: +1 -0 lines
Diff to previous 1.58 (colored)

Add a command variable for 'LATEX' so we can draw figures using LATEX
and then convert them to .eps files with dvips -E.

Revision 1.58 / (download) - annotate - [select for diffs], Wed Dec 12 11:49:37 2001 UTC (10 years, 1 month ago) by phantom
Branch: MAIN
Changes since 1.57: +1 -1 lines
Diff to previous 1.57 (colored)

Force tidy(1) to use '-raw' and newly added '-preserve' options
to process generated HTML. This not cause any side effects except
leaving some character entities in their numeric form instead
converting them into alphabetical notation (&#60; instead of &lt;),
but since all browsers understand such cases it is not a problem.

This commit should make all translations tidy clean, since
tidy should not arise entities conversion problem as it did
for long time before. Therefore all occurences of manual settings
of TIDYFLAGS and NO_TIDY declarations for translations are removed.

No objections from: -doc
Requested by: Russian and Japanese translation teams

Revision 1.57 / (download) - annotate - [select for diffs], Mon Nov 19 06:11:16 2001 UTC (10 years, 2 months ago) by murray
Branch: MAIN
Changes since 1.56: +9 -10 lines
Diff to previous 1.56 (colored)

Rework our index support.

  * Add a new document-specific variable, HAS_INDEX, to specify if a
    given document is marked up with <indexterm> entries.

  * Rework the index support so that both HAS_INDEX and GEN_INDEX are
    checked before trying to generate an index for a document.

  * Only create index.sgml if both HAS_INDEX and GEN_INDEX are set.

This allows us to recursively build the documentation tree with
GEN_INDEX=1 and have it only try to create an index (very time
consuming) for the few documents that are ready for this.  Previously,
running "make GEN_INDEX=1" from the top of the doc tree would look for
index terms in every single document.

With this, I hope we can start building our docs with GEN_INDEX set on
freefall so that users browsing the HTML docs will get the benefit of
the index we've been hiding in CVS for 6 months.

Revision 1.56 / (download) - annotate - [select for diffs], Tue Nov 6 04:27:39 2001 UTC (10 years, 3 months ago) by murray
Branch: MAIN
Changes since 1.55: +1 -1 lines
Diff to previous 1.55 (colored)

Fix typo in last commit.

Revision 1.55 / (download) - annotate - [select for diffs], Mon Nov 5 10:43:17 2001 UTC (10 years, 3 months ago) by murray
Branch: MAIN
Changes since 1.54: +4 -2 lines
Diff to previous 1.54 (colored)

Add a ISO8879 catalog entry.

Submitted by:	Cyrille Lefevre <clefevre@citeweb.net>

Revision 1.54 / (download) - annotate - [select for diffs], Mon Nov 5 10:33:38 2001 UTC (10 years, 3 months ago) by murray
Branch: MAIN
Changes since 1.53: +9 -9 lines
Diff to previous 1.53 (colored)

Make the TIDYFLAGS/TIDYOPTS usage homologous to the rest of the make
variables in the doc infrastructure.  Fixes several small bugs.

PR:		docs/31703
Submitted by:	Akio Morita <amorita@FreeBSD.org>

Revision 1.53 / (download) - annotate - [select for diffs], Tue Oct 30 21:37:53 2001 UTC (10 years, 3 months ago) by bmah
Branch: MAIN
Changes since 1.52: +3 -3 lines
Diff to previous 1.52 (colored)

Unbreak PDF file building.

Revision 1.52 / (download) - annotate - [select for diffs], Mon Oct 29 09:21:53 2001 UTC (10 years, 3 months ago) by murray
Branch: MAIN
Changes since 1.51: +273 -162 lines
Diff to previous 1.51 (colored)

Make build/install /usr/obj prefix clean.

Also fix several minor bugs here, such as leftover files not being
deleted after 'make clean'.

PR:		docs/31131
Submitted by:	Cyrille Lefevre <clefevre@citeweb.net>

Revision 1.51 / (download) - annotate - [select for diffs], Thu Oct 4 09:40:31 2001 UTC (10 years, 4 months ago) by murray
Branch: MAIN
CVS Tags: ISBN_1-57176-303-1
Changes since 1.50: +2 -1 lines
Diff to previous 1.50 (colored)

Fix `make lint' for the handbook by hiding the index behind a
parameter entity.

Revision 1.50 / (download) - annotate - [select for diffs], Mon Sep 17 09:45:01 2001 UTC (10 years, 4 months ago) by murray
Branch: MAIN
Changes since 1.49: +9 -1 lines
Diff to previous 1.49 (colored)

Add a knob to trace TeX's memory usage.  This is useful when you're
using tons of different macro packages (like we do) and something is
misbehaving. ``make TRACE=1 book.ps''

Revision 1.49 / (download) - annotate - [select for diffs], Tue Sep 11 02:32:32 2001 UTC (10 years, 5 months ago) by murray
Branch: MAIN
Changes since 1.48: +2 -2 lines
Diff to previous 1.48 (colored)

Turn on -ioutput.print.twoside in the TWO_SIDE=1 case (which is also
the BOOK_OUTPUT=1 case).

Revision 1.48 / (download) - annotate - [select for diffs], Tue Sep 11 00:38:32 2001 UTC (10 years, 5 months ago) by murray
Branch: MAIN
Changes since 1.47: +2 -1 lines
Diff to previous 1.47 (colored)

Add justification to the list of features that
'make BOOK_OUTPUT=1 book.ps' gives you.

Revision 1.47 / (download) - annotate - [select for diffs], Sat Sep 8 01:59:22 2001 UTC (10 years, 5 months ago) by murray
Branch: MAIN
Changes since 1.46: +9 -1 lines
Diff to previous 1.46 (colored)

Add a new option 'JUSTIFY' which can be used to tell the TeX backend
to make the paragraphs right justified using TeX's default hyphenation
rules.  We still must add some hooks to certain elements (URLs) to
deal with special cases that TeX can't hyphenate well.

Revision 1.46 / (download) - annotate - [select for diffs], Fri Sep 7 10:21:41 2001 UTC (10 years, 5 months ago) by murray
Branch: MAIN
Changes since 1.45: +28 -4 lines
Diff to previous 1.45 (colored)

Add two new options to our documentation infrastructure.

    TWO_SIDE    - If defined, two sided output will be created.  This
                  means that new chapters will only start on odd
                  numbered (aka right side, aka recto) pages and the
                  headers and footers will be aligned appropriately
                  for double sided paper.  Blank pages may be added as
                  needed.

    BOOK_OUTPUT - If defined, this will set all of the other
                  print-output options that can significantly increase
                  the build time, but make for much nicer looking
                  output.

To implement the two sided output, we need to override a TeX variable
to control the behavior of the JadeTeX macro package.  So this also
introduces a TEXCMDS variable that can be set with additional TeX
commands that should be run before processing the input TeX document.
In the TWO_SIDE case, we simply set it to \def\PageTwoSide{1}

Revision 1.45 / (download) - annotate - [select for diffs], Thu Aug 23 07:59:06 2001 UTC (10 years, 5 months ago) by murray
Branch: MAIN
CVS Tags: RELEASE_4_4_0
Changes since 1.44: +2 -1 lines
Diff to previous 1.44 (colored)

Add a new target to the Handbook makefile: 'pgpkeyring'.

This target finds all <programlisting role="pgpkey"> elements in the
Handbook and writes out a flat text file suitable for importing into
PGP or GPG.

This can be used in the web build to automatically update the public
keyring of FreeBSD developers.

Revision 1.44 / (download) - annotate - [select for diffs], Wed Aug 22 22:30:26 2001 UTC (10 years, 5 months ago) by nik
Branch: MAIN
Changes since 1.43: +6 -4 lines
Diff to previous 1.43 (colored)

Discover the -s parameter to pkg_create, and remove the dependency on
installing the files before packaging them up.

Revision 1.43 / (download) - annotate - [select for diffs], Thu Aug 16 05:19:51 2001 UTC (10 years, 5 months ago) by dd
Branch: MAIN
Changes since 1.42: +9 -4 lines
Diff to previous 1.42 (colored)

An increasing amount of documents use the -V flag to Jade via
JADEFLAGS to set variables such as %generate-article-toc%.  However,
JADEFLAGS is also passed to nsgmls, which doesn't, and shouldn't,
understand -V.  The Makefiles which do this are correct, because the
name--JADEFLAGS--implies that it will only be passed to Jade, not to
nsgmls, too.  Furthermore, simply not passing JADEFLAGS to nsgmls is
not okay, since nsgmls *does* need the -i flags used to
include/exclude certain parts of the document.

Remedy this by breaking up JADEFLAGS into itself and SGMLFLAGS.  The
latter will be passed to all SGML processors such as nsgmls and Jade.
The former will only be passed to Jade.  The -V flags should stay in
JADEFLAGS, and the -i flags should be moved to SGMLFLAGS.

This fixes `make lint` for documents which use -V via JADEFLAGS.

Reviewed by:	bmah

Revision 1.42 / (download) - annotate - [select for diffs], Sat Jul 28 03:00:03 2001 UTC (10 years, 6 months ago) by murray
Branch: MAIN
Changes since 1.41: +21 -9 lines
Diff to previous 1.41 (colored)

Add a new tunable knob 'MIN_SECT_LABELS' and the necessary stylesheet
support.

This option prevents section labels from being numbered after the third
level.

make FORMATS=ps :

  "N.N.N Section Title"
  "N.N.N.N really specific topic"
  "N.N.N.N.N really-really specific topic"

make MIN_SECT_LABELS=1 FORMATS=ps :

  "N.N.N Section Title"
  "really specific topic"
  "really-really specific topic"

The section titles are still bold, spaced away from the text, and
sized according to their nesting level.

Revision 1.41 / (download) - annotate - [select for diffs], Sat Jul 21 03:44:27 2001 UTC (10 years, 6 months ago) by murray
Branch: MAIN
Changes since 1.40: +6 -5 lines
Diff to previous 1.40 (colored)

Allow NICE_HEADERS to be used in the GEN_INDEX case.

NICE_HEADERS is a set of print-only enhancements, however the HTML
backend is invoked whenever an index is generated, so we should not
touch JADEOPTS directly and should instead modify the .tex-ps target
directly.

Revision 1.40 / (download) - annotate - [select for diffs], Mon Jul 16 15:11:54 2001 UTC (10 years, 6 months ago) by nik
Branch: MAIN
Changes since 1.39: +2 -2 lines
Diff to previous 1.39 (colored)

Add JADEFLAGS to the nsgmls command line, so that any special "-i" settings
get passed down properly.  This fixes "make lint" for the Handbook, now that
the chapters are individually buildable.

Revision 1.39 / (download) - annotate - [select for diffs], Mon Jul 16 05:00:20 2001 UTC (10 years, 6 months ago) by murray
Branch: MAIN
Changes since 1.38: +10 -1 lines
Diff to previous 1.38 (colored)

Introduce a 'NICE_HEADERS' tuneable knob that creates customized
chapter headers that you may find more aesthetically pleasing than the
rather spartan chapter headers in Norm's print stylesheets.  This
option only effects print output formats for English language books.

Also move the local-en-label-title-sep customization from share/sgml
to en_blah/share/sgml since the best values for this customization
depend on the locale.

This changes (make FORMATS=ps) :

    Chapter 7. Users and Basic Account Management

    7.1. Synopsis

into (make NICE_HEADERS=1 FORMATS=ps) :

    Chapter 7
    /Users and Basic Account Management/

    7.1  Synopsis

More work needs to be done for the NICE_HEADERS case to enhance the
output, but I think its an improvement.

Revision 1.38 / (download) - annotate - [select for diffs], Sat Jul 14 18:04:06 2001 UTC (10 years, 6 months ago) by chris
Branch: MAIN
Changes since 1.37: +2 -2 lines
Diff to previous 1.37 (colored)

Add a dependancy on ${CSS_SHEET} for the docbook.css target.  Without this,
one must run a `make clean' (or `rm docbook.css') or the stylesheet is not
updated, regardless of whether or not it's been updated since the last
build.

Revision 1.37 / (download) - annotate - [select for diffs], Thu Jul 12 00:24:59 2001 UTC (10 years, 7 months ago) by dd
Branch: MAIN
Changes since 1.36: +7 -2 lines
Diff to previous 1.36 (colored)

Add INDEX_SGML and docbook.css to CLEANFILES as appropriate.

PR:		28864
Submitted by:	Alex Kapranoff <kapr@acm.org>

Revision 1.36 / (download) - annotate - [select for diffs], Tue Jul 10 03:06:48 2001 UTC (10 years, 7 months ago) by murray
Branch: MAIN
Changes since 1.35: +10 -2 lines
Diff to previous 1.35 (colored)

Slight modification to support the case where a document contains
indexterms, but we don't want to generate the index.

Specifically, touch the ${INDEX_SGML} file if ${GEN_INDEX} is not set.

Suggested by: Nik

Revision 1.35 / (download) - annotate - [select for diffs], Thu Jun 21 03:03:51 2001 UTC (10 years, 7 months ago) by chris
Branch: MAIN
Changes since 1.34: +1 -1 lines
Diff to previous 1.34 (colored)

Null commit:
  Apparently either my editor or CVS appended a new-line at the end
  of this file, which was a part of the previous delta.

Revision 1.34 / (download) - annotate - [select for diffs], Thu Jun 21 02:55:59 2001 UTC (10 years, 7 months ago) by chris
Branch: MAIN
Changes since 1.33: +3 -3 lines
Diff to previous 1.33 (colored)

Include ${LANGUAGECATALOG} in `make validate' nsgmls command line arguments.

Revision 1.33 / (download) - annotate - [select for diffs], Mon Jun 18 14:24:08 2001 UTC (10 years, 7 months ago) by nik
Branch: MAIN
Changes since 1.32: +17 -3 lines
Diff to previous 1.32 (colored)

Pull in docbook.css as necessary.

Revision 1.32 / (download) - annotate - [select for diffs], Sat Jun 16 14:11:52 2001 UTC (10 years, 7 months ago) by nik
Branch: MAIN
Changes since 1.31: +55 -17 lines
Diff to previous 1.31 (colored)

Rewrite the index generation support -- this seems to do the right thing,
and doesn't break the build in the non-GEN_INDEX case, so it's safe to
commit.  I need more people testing it though.

Revision 1.31 / (download) - annotate - [select for diffs], Tue Mar 27 16:15:07 2001 UTC (10 years, 10 months ago) by nik
Branch: MAIN
CVS Tags: RELEASE_4_3_0
Changes since 1.30: +2 -2 lines
Diff to previous 1.30 (colored)

Fix small error that meant that library images weren't being included in
any generated tarballs.

Revision 1.30 / (download) - annotate - [select for diffs], Thu Mar 22 22:47:32 2001 UTC (10 years, 10 months ago) by obrien
Branch: MAIN
Changes since 1.29: +6 -2 lines
Diff to previous 1.29 (colored)

Separate the Alpha arch test and the OPENJADE test.  This also gets
"OPENJADE" exported in the Alpha case so it matches the non-Alpha case.

Silence by:	doc@freebsd.org

Revision 1.29 / (download) - annotate - [select for diffs], Sun Mar 18 15:48:10 2001 UTC (10 years, 10 months ago) by alex
Branch: MAIN
Changes since 1.28: +6 -6 lines
Diff to previous 1.28 (colored)

Now really do use openjade on alpha.

PR:		25891
Submitted by:	Christian Weisgerber <naddy@mips.inka.de>

Revision 1.28 / (download) - annotate - [select for diffs], Sun Mar 11 18:26:06 2001 UTC (10 years, 11 months ago) by nik
Branch: MAIN
Changes since 1.27: +3 -3 lines
Diff to previous 1.27 (colored)

Use openjade if we're on an Alpha.  Use links instead of w3m.

Revision 1.27 / (download) - annotate - [select for diffs], Mon Feb 26 22:56:59 2001 UTC (10 years, 11 months ago) by nik
Branch: MAIN
Changes since 1.26: +7 -7 lines
Diff to previous 1.26 (colored)

Use a different mechanism to specify the input file to TeX.

<aph>  running, for instance, "jadetex '\nonstopmode\input{$<}'" is much
       better since it won't crash out an automated build as badly
<nik_> Huh?
<aph>  it will fail rather than kick you into a TeX prompt and wait for output
<aph>  I guess in BSD make that would be:
<aph>  jadetex '\nonstopmode\input{${.ALLSRC}'

Submitted by:	Adam di Carlo <adam@onshore.com>

Revision 1.26 / (download) - annotate - [select for diffs], Thu Feb 22 15:42:41 2001 UTC (10 years, 11 months ago) by nik
Branch: MAIN
Changes since 1.25: +28 -6 lines
Diff to previous 1.25 (colored)

1. Add a new knob, GEN_INDEX.  If defined (nothing does yet), collateindex.pl
will be run to generate index.sgml, an automatically generated index for
the document.  This is also added to the list of dependencies.

2. Add a DOCBOOKSUFFIX variable, defaulting to "sgml", so we can write

   MASTERDOC?=  ${.CURDIR}/${DOC}.${DOCBOOKSUFFIX}

Requested by:   Michael Wiedmann <mw@miwie.in-berlin.de>
                Linux Documentation Project

3. Set the DSSSL 'openjade' variable to #t if we're processing with
   OpenJade.

4. Work around a bug in the stylesheets.  If we split the <legalnotice>
   out in to a separate file it isn't added to the HTML.manifest.  Check
   for it by hand, and include it if necessary.

Revision 1.25 / (download) - annotate - [select for diffs], Tue Oct 31 14:39:13 2000 UTC (11 years, 3 months ago) by kuriyama
Branch: MAIN
CVS Tags: RELEASE_4_2_0
Changes since 1.24: +3 -3 lines
Diff to previous 1.24 (colored)

Remove ${.TARGET} if jade failed.

Revision 1.24 / (download) - annotate - [select for diffs], Sun Oct 29 18:01:54 2000 UTC (11 years, 3 months ago) by nik
Branch: MAIN
Changes since 1.23: +19 -3 lines
Diff to previous 1.23 (colored)

Support installing images where the document and images are split up over
multiple directories, the way (for example) that the Handbook is.

Revision 1.23 / (download) - annotate - [select for diffs], Sun Oct 29 02:39:10 2000 UTC (11 years, 3 months ago) by nik
Branch: MAIN
Changes since 1.22: +32 -17 lines
Diff to previous 1.22 (colored)

LIB_IMAGES -> IMAGES_LIB, to be consistent with IMAGES_PNG and IMAGES_EPS

Extend the image support.  Now handles the "install" part for HTML, PS, and
PDF, as well as packaging.

Better support for images in the PDF output.  I'm still trying to figure out
how to get good quality PDF from EPS source though.

Revision 1.22 / (download) - annotate - [select for diffs], Tue Oct 10 06:16:56 2000 UTC (11 years, 4 months ago) by kuriyama
Branch: MAIN
Changes since 1.21: +7 -3 lines
Diff to previous 1.21 (colored)

Temporary fix to make this buildable.

Submitted by:	crossd@cs.rpi.edu

Revision 1.21 / (download) - annotate - [select for diffs], Sun Oct 8 19:19:09 2000 UTC (11 years, 4 months ago) by nik
Branch: MAIN
Changes since 1.20: +27 -16 lines
Diff to previous 1.20 (colored)

Support images in the documentation.

For producing text-only docs, we need to have a second HTML target.

The PS and PDF targets (which depended on a .tex file) have been split
out so that they each depend on their own .tex-${format} file, to get
the image formats correct.

Revision 1.20 / (download) - annotate - [select for diffs], Sat Oct 7 16:31:04 2000 UTC (11 years, 4 months ago) by nbm
Branch: MAIN
Changes since 1.19: +3 -1 lines
Diff to previous 1.19 (colored)

Make 'make lint' work again.  Obviously no-one uses it. (:

(I forgot to set NSGMLS)

Revision 1.19 / (download) - annotate - [select for diffs], Thu Sep 28 23:34:49 2000 UTC (11 years, 4 months ago) by nbm
Branch: MAIN
Changes since 1.18: +9 -4 lines
Diff to previous 1.18 (colored)

If OPENJADE is defined, use the openjade replacement tools like
'openjade', 'onsgmls', like 'osgmlnorm'.

Revision 1.18 / (download) - annotate - [select for diffs], Thu Sep 28 23:29:47 2000 UTC (11 years, 4 months ago) by nbm
Branch: MAIN
Changes since 1.17: +11 -9 lines
Diff to previous 1.17 (colored)

a) "Fix" out-of-tree builds by not hard-coding locations of dsl files
with SYSTEM, and using instead PUBLIC entities gained from the catalog
in the directory of the language the document belongs to, or the
language-neutral entity.  Now we always use default.dsl as our dsl
master, and it grabs the necessary magic from the catalogs.

b) Fix the always-out-of-date imagelib problem with some make(1)-fu.

Approved by:	nik (ages ago)

Revision 1.17 / (download) - annotate - [select for diffs], Mon Sep 25 08:17:03 2000 UTC (11 years, 4 months ago) by nik
Branch: MAIN
Changes since 1.16: +2 -2 lines
Diff to previous 1.16 (colored)

Add ${DSSSLCATALOG} and ${JADECATALOG} to the list of catalogs the lint:
target uses -- this ensures that any options (such as "OMITTAG NO") that
are used when building the docs are also used when linting them, so that
errors don't slip through the cracks.

Prompted by r1.93 of the FAQ.

Revision 1.16 / (download) - annotate - [select for diffs], Tue Jul 18 16:30:45 2000 UTC (11 years, 6 months ago) by nik
Branch: MAIN
CVS Tags: RELEASE_4_1_0
Changes since 1.15: +5 -3 lines
Diff to previous 1.15 (colored)

doc.images.mk

LOCAL_LIB_IMAGES_DIR should be a path component, not a complete path, so
remove ${.CURDIR}.

doc.docbook.mk

Set the directory for image installation correctly, and ensure that the
directory exists before we try and do anything with it.

These should fix the installation problems people are having with the
primer.  There's still an outstanding bug -- make(1) thinks that the
local library images are out-of-date with respect to the ones in
share/images for some reason.  This forces a rebuild each time.  I'm
still looking at that.

Revision 1.15 / (download) - annotate - [select for diffs], Mon Jul 17 22:30:03 2000 UTC (11 years, 6 months ago) by nik
Branch: MAIN
Changes since 1.14: +4 -3 lines
Diff to previous 1.14 (colored)

Fix the problem where <foo>.html.gz was being listed as a dependency, and
we don't need it anymore.

I'm fixing this from Kirk's tutorial at the O'Reilly Open Source conference.
He was no help at all. . .

Revision 1.14 / (download) - annotate - [select for diffs], Mon Jul 17 08:51:38 2000 UTC (11 years, 6 months ago) by nbm
Branch: MAIN
Changes since 1.13: +3 -3 lines
Diff to previous 1.13 (colored)

LANGCODE, not LANG_CODE.  Of course, it passed testing, because
doc//share/sgml/freebsd.dsl exists.

Revision 1.13 / (download) - annotate - [select for diffs], Sun Jul 16 16:32:27 2000 UTC (11 years, 6 months ago) by nik
Branch: MAIN
Changes since 1.12: +29 -11 lines
Diff to previous 1.12 (colored)

Support library images.  Do this by

1.  Listing LIB_IMAGES as a dependency on certain targets, to ensure
    that library images are pulled in correctly.

2.  Create a new FORMAT, html.tar, to cater for the case where we might
    be producing a single .html file, but we need to tar that up for
    distribution and the tar file needs to include all the images.

3.  Update the various install-* targets to include the images.

4.  Update the package-* targets to include the images

While I'm here, pull out the .doc target.  For some reason I thought our
tool chain could produce Microsoft Word .doc files.  It can't.

Revision 1.12 / (download) - annotate - [select for diffs], Fri Jul 14 08:42:49 2000 UTC (11 years, 6 months ago) by nbm
Branch: MAIN
Changes since 1.11: +3 -3 lines
Diff to previous 1.11 (colored)

1) Use non-relative path to the DSL location, which makes external
document building work again.

2) Add support for building html documents, which is required for
ipsec-must document.

Revision 1.11 / (download) - annotate - [select for diffs], Sat Apr 29 07:46:15 2000 UTC (11 years, 9 months ago) by kuriyama
Branch: MAIN
CVS Tags: RELEASE_3_5_0
Changes since 1.10: +3 -3 lines
Diff to previous 1.10 (colored)

Do xargs only if HTML.manifest is exist.

Revision 1.10 / (download) - annotate - [select for diffs], Fri Mar 24 19:31:34 2000 UTC (11 years, 10 months ago) by nbm
Branch: MAIN
Changes since 1.9: +3 -3 lines
Diff to previous 1.9 (colored)

Fix the new localized dsl stuff for the obj build case.

Revision 1.9 / (download) - annotate - [select for diffs], Thu Mar 23 09:00:15 2000 UTC (11 years, 10 months ago) by nik
Branch: MAIN
Changes since 1.8: +9 -6 lines
Diff to previous 1.8 (colored)

Give each language and encoding it's own freebsd.dsl, to contain style
sheet definitions for that language only.  Each file reads in the defaults
from the master share/sgml/freebsd.dsl file, and adds overrides, or new
definitions, as necessary.

Move the per-language hacks from share/sgml/freebsd.dsl in to
<lang>/share/sgml/freebsd.dsl as necessary.

Add links to the -questions and -doc mailing lists to the bottom of the
generated HTML output for some languages.  The -questions link will
become a link to Greg's "Getting the most from questions" document when
I bring that in, but I haven't done that yet, and I didn't want these
patches hanging around my local tree.

This was the real reason for making freebsd.dsl language local, as it
makes it much easier to translate generated text, such as the text of
the links, without polluting share/sgml/freebsd.dsl.

Update doc.docbook.mk to use the new, per-language freebsd.dsl file when
building the docs.  While I'm here, update .pdb generation so that it
creates a symlink to ${CURDIR:T}.pdb as well (e.g., the Handbook generates
"book.pdb" and "handbook.pdb").  This makes it easier to install more than
one document on a Palm, because two docs called "book.pdb" or "article.pdb"
can not co-exist.

Revision 1.8 / (download) - annotate - [select for diffs], Wed Mar 8 11:21:37 2000 UTC (11 years, 11 months ago) by nbm
Branch: MAIN
Changes since 1.7: +2 -2 lines
Diff to previous 1.7 (colored)

Fix an obj error in the lint/validate target.

Revision 1.7 / (download) - annotate - [select for diffs], Thu Feb 3 03:10:43 2000 UTC (12 years ago) by kuriyama
Branch: MAIN
Changes since 1.6: +7 -1 lines
Diff to previous 1.6 (colored)

Add NO_TIDY variable to disable tidy.

Tidy cannot handle EUC-JP codepoint range correctly with -raw option.
I will try to fix this problem, but temporary disable to use tidy in
Japanese Handbook and FAQ.

Revision 1.6 / (download) - annotate - [select for diffs], Mon Jan 24 20:02:50 2000 UTC (12 years ago) by nik
Branch: MAIN
Changes since 1.5: +3 -3 lines
Diff to previous 1.5 (colored)

Allow DSLHTML and DSLPRINT to be overridden ("...=" -> "...?=").

Requested by:	Chris Costello

Revision 1.5 / (download) - annotate - [select for diffs], Fri Dec 24 01:25:27 1999 UTC (12 years, 1 month ago) by nik
Branch: MAIN
Changes since 1.4: +5 -5 lines
Diff to previous 1.4 (colored)

Use w3m instead of lynx to format the text versions.  It's table handling
is superior, and the various translation teams are fine with it.

Use iSilo instead of pilot-makedoc to produce Palm compatible files.  It
works from the HTML and retains the formatting (including the internal
links) making it much nicer to work with than the output from pilot-makedoc.

Revision 1.4 / (download) - annotate - [select for diffs], Mon Dec 13 18:14:41 1999 UTC (12 years, 1 month ago) by nik
Branch: MAIN
Changes since 1.3: +8 -2 lines
Diff to previous 1.3 (colored)

Experimental support for building Palm Pilot DOC format files.  The result
works, but isn't great (at least in SmartDOC).  Still, if you want to carry
the FreeBSD FAQ on your Palm (or the Handbook for that matter) it's a start.

PR:             docs/13439
Submitted by:   Slaven Rezic <eserte@cs.tu-berlin.de>

Revision 1.3 / (download) - annotate - [select for diffs], Mon Nov 1 19:41:02 1999 UTC (12 years, 3 months ago) by nik
Branch: MAIN
Changes since 1.2: +2 -2 lines
Diff to previous 1.2 (colored)

Change the invocation of tidy(1) in the index.html target to only update
the .html files that have been built, instead of all of them.  Fixes a bug
where "make FORMATS='html-split html'" would only update the split HTML
files.

Reported by:    Mark Ovens <mark@ukug.uk.FreeBSD.org>
Submitted by:   Neil Blakey-Milner <nbm@mithrandir.moria.org>

Revision 1.2 / (download) - annotate - [select for diffs], Mon Sep 6 06:53:39 1999 UTC (12 years, 5 months ago) by peter
Branch: MAIN
Changes since 1.1: +1 -1 lines
Diff to previous 1.1 (colored)

$Id$ -> $FreeBSD$

Revision 1.1 / (download) - annotate - [select for diffs], Fri Sep 3 17:07:18 1999 UTC (12 years, 5 months ago) by nik
Branch: MAIN

New make(1) infrastructure.  Split out docproj.docbook.mk into a number
of smaller doc.<foo>.mk files, reflecting the functionality they contain.
Long overdue, kudos to the submitter for the carrying out the work.

Also makes the files independent of the system include files that
normally live in /usr/share/mk, making it easier for non-FreeBSD systems
to download and build our docs (an important factor in making it easier
to share our work with other projects).

Finally, it (in theory) lets you build the docs with a r/o doc/ directory.

Changes to the submitted files:

doc.docbook.mk    The HTML generation depends on ${DSLHTML}, and the
                  print generation depends on ${DSLPRINT}.  Changing
                  these files will force a rebuild (which makes testing
                  changes a little easier).

                  Removed ${DOC}.doc target.  It's a hangover from when
                  I (mistakenly) thought that Jade could generate MS Word
                  .doc files.

                  Added support for using compress(1) to build .Z files
                  (been on my todo list for ages).

                  Fixed a couple of typos.

Submitted by:   Neil Blakey-Milner <nbm@mithrandr.moria.org>

This form allows you to request diff's between any two revisions of a file. You may select a symbolic revision name using the selection box or you may type in a numeric name using the type-in text box.

Diffs between
and

www@jp.FreeBSD.org
2002/09/30 21:02:05