and provide links to STYLE.MAKEFILE(5).
PR: docs/160696
Submitted by: radiomlodychbandytow at o2 dot pl
Discussed on: freebsd-doc
^M removal help by: gjb
This may help a bit when people are not familiar with the specific
meaning of RCS we are alluding to in the dev handbook.
Triggered by: A discussion with other doc-people
and Walt Pawley, walt at wump.org.
1. Mention src/MAINTAINERS and how it works.
2. Add a short suggestion about how to identify possible
maintainers, inspired by the committers-guide
3. Tcl has been removed from the base distribution, so it does
not really serve as a good example of contributed software any
more (obsoletes docs/50735)
4. Mention the growing use of FREEBSD-Xlist files for contrib software
5. Describe how vendor imports of Subversion code can be done (inspired
by the Subversion docs of the Wiki).
6. Use slightly more up to date release numbers when describing library
version bumps.
Submitted by: Gavin Atkinson <gavin@freebsd.org>
Patches by: gavin, pgj, keramida
PR: docs/126030
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.
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
- Various grammar fixes.
- Change "ie." to "i.e."
- Convert quotes to <quote> or other more appropriate tags.
PR: docs/34967
Submitted by: Ceri <setantae@submonkey.net>
* Use ftp.hostname.com/directory rather than
ftp.hostname.com:directory.
* s/freebsd.org/FreeBSD.org/
* Use relative links for FreeBSD.org documents
PR: 31447
Submitted by: Cyrille Lefevre
Found by: linbot
most of the other spurious comments.
Two comments relating to copyright have *not* been merged in from the
LinuxDoc version yet -- I've contacted the original authors to ask if
they would be willing to assign the copyright to the project. When I
get their response the copyright comments will either be merged in, or
left out, as necessary.
Rationale: All the changes to the DocBook handbook so far have been
careful to keep whitespace changes to a minimum. This is so the
translators have as easy a job as possible in identifying exactly what's
changed.
This has meant the English version has become more and more 'ugly'. Lines
indented by the wrong amount, some lines longer than 130 characters,
others shorter than 20, gaps of 3 or 4 lines between paragraphs (and
sometimes within paragraphs). This makes it difficult to follow the
structure of the document, and needlessly complicates fixing SGML
problems.
It also makes the source practically useless as a teaching aid; the
more baroque the source looks, the less likely people are to dive in and
contribute.
This commit fixes all that -- and boy was it tedious. The snag is, it's
touched almost every line in every file in the Handbook.
Technically, the changes were made by running (in Emacs)
sgml-indent-or-tab (bound to the TAB key) on almost each line (except
those in <programlisting>, <screen>, <literallayout>, and other
verbatim sections), and then running sgml-fill-element (bound to
C-c C-q) on most paragraphs.
FWIW, this is the first, only, and last change of this type contemplated.
