- Eliminate a <blockquote> inside <para> (split <para> around <blockquote>)
- Use <sgmltag> markup where possible
- nsgmls does not always give error messages, just messages (those might
contain information on errors)
- Eliminate first person narration
- Add missing full stops
- Add a missing <literal> markup for CDATA
Reviewed by: blackend, danger, gabor, hrs, manolis, remko, trhodes
first defined in ${SGMLROOT}/html/catalog and ${SGML_ROOT}/iso8879/catalog.
By setting the SGML_CATALOG_FILES in the order suggested until now, we end
up with a value of SGML_CATALOG_FILES like (wrapped to keep the length of
the lines reasonable):
/usr/doc/en_US.ISO8859-1/share/sgml/catalog:/usr/doc/share/sgml/catalog:\
/usr/local/share/sgml/docbook/4.1/catalog:/usr/local/share/sgml/html/catalog:\
/usr/local/share/sgml/iso8879/catalog:/usr/local/share/sgml/jade/catalog
This means that when `dbcent.mod' refers to entities like %ISOamsa; they
are not known already (because they are defined in catalog files later in
the search path, not loaded by nsgmls yet). This results in errors like:
nsgmls:/usr/local/share/sgml/docbook/4.1/dbcent.mod:54:0:E: \
cannot open "/usr/local/share/sgml/docbook/4.1/iso-amsa.gml" \
(No such file or directory)
By rearranging the order of the catalog files a bit, we can convince nsgmls
to load the `html' and `iso8879' public entities first, and make it
possible to use nsgmls to validate DocBook SGML documents too (instead of
HTML only).
PR: docs/48980
Submitted by: Martin Karlsson <mk-freebsd@bredband.net>
be any content changes involved in this commit, however, localization
teams are encouraged to catch up with this change.
Requested by: intron at intron ac
Reviewed by: Niclas Zeising <lothrandil at n00b apagnu se>
Glanced by: simon
sentence at the end of a paragraph so that the readers don't think
that some text is missing.
Consistently use colons to finish sentences introductory to examples.
informaltable element properly, unless the pgwide attribute is
explicitly set to 1. Use this consistently within the (en) tree, and
update the FDP accordingly. This should finally silence the demons in:
PR: docs/73095
Submitted by: Hilko Meyer <Hilko dot Meyer at gmx dot de>
- Use of .cshrc as "startup" file for csh(1) and tcsh(1) instead of
.login
- Some British English -> American English
organise(d) -> organize(d)
organisation -> organization
generalised -> generalized
PR: docs/54456
Submitted by: Ken Smith <kensmith@cse.Buffalo.EDU>
There is one remaining place in the fdp-primer, but that needs
a bit more work.
Inspired by: docs/36462 (Gary W. Swearingen <swear@blarg.net>)
Reviewed by: ceri, trhodes
FreeBSD-specific catalog files are set during this tutorial; this will
answer a common FreeBSD docproj complaint on complaints generated by
emacs.
"if it's wrong, fix it" by: nik
to ports as in the FreeBSD Ports Collection.
As pointed out by Nik and others, the <port> tag is not the best way
to mark up Ports Collection ports. However, for the present it is
the best we have, and the least we can do is be consistent in its
usage :)
Approved as a temp "best current practice" measure by: bmah, -doc
internet -> Internet
can not -> cannot
CD-ROM -> CDROM
cdrom -> CDROM
UNIX -> Unix
To be standardized with the rest of the doc tree.
Approved by: murray
(the FAQ) no longer exists, and validator.w3.org isn't really relevant in
this situation. Also removed the %not.published; bits around it.
PR: 22419
Submitted by: Paul Fardy <pdf+fdp@mun.ca>
page due to the new W3C validator service, temporarily do not publish
the "more info about nsgmls error codes can be found ..." paragraph,
until a similar page is available.
PR: 18343
Submitted by: Paul Southworth <pauls@etext.org>
Reviewed by: jim
enough for most people, and gets it into the repository, making it
easier for others to add to as necessary.
This has not (yet) been turned on in the upper level Makefile or
listed on the web site yet, I want to get some more feedback
from readers first. It should be "made visible" later this week.
