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
a Developer Handbook.
In 5 years we haven't had anyone contribute a chapter on Alpha
Assembly Language programming, Linux Compatability, Syscons, UFS,
AFS/NFS, or Signals. If someone wants to in the future, great, but
there is no need for empty stub chapters anymore.
There are much better sources for this content in the D&I book and
Stevens' APUE.
Removing these stubs makes the content that we do have more apparent,
rather than focussing on what has yet to be written.
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>
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.
is not defined.
- URL_RELPREFIX must always point the top page's URL
(http://www.FreeBSD.org) in relative form, defined in Makefile.
- &url.base; can be used in doc/<langcode>/*. It will be
replaced with the real URL which points the top page.
For translators: Please make sure to define URL_RELPREFIX to
point the top page. The localized docs have different directory
hierarchy in its URL from the English version.
Tested by: den
changes was done to the original after the repo-copy, so merge in
those changes (v. 1.21-1.28). Since this file has also been changed
since the repo-copy the changes was merge in by hand, so it is not a
straight merge of the changes.
Note: This chapter seems seriously out-of-date.
Ihis entity auto-replaced with ../../../.. by default
and with http://www.FreeBSD.org/ when URLS_ABSOLUTE is set
(used for mirrors and for release building accordingly)
- Use trademark entities.
- Add trademark attributions.
- Don't join trademarks with other words, e.g. using hyphens.
trademark.ent:
- Add trademark entity for Sun.
At the moment the main content is the Micro Benchmark Checklist posted
to -current by phk and expanded by rwatson. The list did not really fit
in any of the current chapters, so a new chapter was created. I hope
others can add more content to this chapter later.
Content by: phk, rwatson
Reviewed by: phk, josef
No objections: -doc
dump and the basics of what most developers would like to see in reports
of a panic where a dump is available. Also trim a few lines from the
previous dump example (still included) and sync up some of the gdb
commands for the sake of consistency.
Inspired by: Recent exchange with jhb
instructions inline with reality (ex: savecore hasn't had the -N flag for
a while). The verbage here should be sufficient for developers to be able
to point users on current@ to these first two sections and have them
extract something reasonably useful, esp now that -CURRENT no longer means
FreeBSD 3.1.
various examples so that this chapter is useful to new and unsuspecting
vict^H^H^H^Huser^H^H^H^Hkernel debuggers.
Submitted by: echo "(setq-default show-trailing-whitespace t)" >> ~/.emacs
