category and change the master list of categories to point the CVSweb
location, which should always have the latest list.
Spurred by email from: obrien
Currently we have articles.ent and books.ent, and
for example, articles.ent can be used by putting the
following lines in the doctype declaration:
<!ENTITY % articles.ent PUBLIC
"-//FreeBSD//ENTITIES DocBook FreeBSD Articles Entity Set//EN">
%articles.ent;
This pulls all of the necessary entities via share/sgml/articles.ent.
The translation teams can customize these entities by redefining
the articles.ent file in <langcode>/share/sgml. See
ja_JP.eucJP/share/sgml for example.
a good Problem Report. Add pointers to the new files ports/CHANGES
and ports/UPDATING. Change some occurrences of FreeBSD to &os; if
they were in the affected lines (another commit will do the remaining
ones). Suggest guidelines for the often-abused Severity and Priority
fields. Add a pointer to the categories definition file. Add the
'threads' category. Add a warning to include the tracking number on
followups to save creating new, bogus, PRs.
PR: docs/67062
Reviewed by: ceri, keramida, others
Approved by: ceri (mentor)
- Add trademark tags as needed, generally on first use in each
article.
- Add an attribution to the legal section mentioning all trademarks
referenced.
- Always use correct case for trademarks.
writing a good problem report" section.
- Fix a few typos.
- Add a link to the searchable gnats database at FreeBSD.org.
- Point the users at /usr/src/UPDATING for more info before sending PRs.
- Be more verbose about patches and inline inclusion of diffs in a PR.
- Emphasize the importance of Class: maintainer-update and the use of
"[maintainer update]"
- Describe what "[patch]" in synopsis lines means now that it's
commonly used to help people who read PR indexes.
Submitted by: Mark Linimon <linimon@lonesome.com>
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$.
between the closing tag and its contents. This change can be ignored
by the translators.
PR: docs/38849 (partially)
Submitted by: Marc Fonvieille <marc@blackend.org>
