* mention svn-arc-all along with cvs-all, the latter is not applicable for src
* update to 2010
Approved by: hrs, philip (mentor)
No screaming: keramida
* don't use RELENG_5 anymore
* don't mention CVS explicitly when the text applies to any version control system
* introduce Subversion (pointers and its usage in the src tree)
* don't mention ncvs as a CVS commit host anymore
* replace all sys/*fs examples in the practical CVS primer by analogous ports/Tools examples
* use ISO yyyy-mm-dd date format for -D flag of cvs
* mention that Subversion stores metadata in .svn directories
* remove text concerning the -j flag of cvs
* mention svn-committers and that it is a normal read/write list
* remove most of q&a 16.2, point to SubversionPrimer/Merging on the wiki instead
Reviewed by: trhodes, gabor, keramida
Approved by: keramida
* use corpauthor
* add 2009
* capitalize "Ports Management Team"
* the "ports frozen" announcement is also sent to ports@
Reviewed by: trhodes, gabor, keramida
Approved by: keramida
* The CD- and DVD-set are no longer available per subscription, but at conferences
* Remove all contractions but "Who's Who"
* Several language and SGML fixes
* Fix capitalization
* Add 2008, since content changes were made last year
* Fix the logical sense of a sentence.
Reviewed by: trhodes, pgj, remko
Approved by: trhodes
Collection [1]
- Add missing reference to pgpkeys-developers.sgml in connection with
adding a new PGP key [2]
PR: docs/122999 [1], docs/122917 [2]
Submitted by: pgj
document as posted to the developers list about three months ago.
Some comments from that time have not been addressed, but will be in
subsequent commits. I had hoped to get them all ironed out before,
but I've been too swamped.
If you have additional comments, please feel free to send them to me.
This recognizes that FreeBSD is increasingly being used in embedded
targets and starts to define what is expected of these embedded
targets at different tier levels, and recognizes that we may do
releases for them differently than we do for server/desktop.
New committers to FreeBSD may be interested about Coverity
Prevent, but it is not very easy to find out how they register,
what license terms Coverity Prevent SQS is available under, and
how they can use the web interface of the automated analysis
runs.
PR: docs/105447
Submitted by: bz
Reviewed by: remko, netchild
not committers, since only a subset of the information here applies to them.
To date, this has only included people who have been given GNATS access
without a commit bit.
The refactoring of the text is admittedly awkward, but anything else
would probably be a significant rewrite.
Hat: bugmeister
Reviewed by: core
the Committer's Guide ports repo-copy section and in the package naming
section of the Porter's Handbook. In the end, I wrote something that
turned out quite a bit different and somewhat more long-winded than
the suggestions in the PR, but LATEST_LINK was not documented anywhere
until now, so there :)
PR: 66775
Submitted by: eik
There's some useful stuff left in this section still, but we should
seriously consider removing it altogether and moving the important
bits somewhere else, since maintaining redundant information like
this isn't really constructive work.
/usr/share/examples/etc/bsd-style-copyright. There were a number of
minor wording and formatting differences. Provide it in C source
code format.
Add text talking about non-BSD licenses in the tree, including
limitations.
Add a paragraph adding strong caution when it comes to intellectual
property, pointing at the core team as a contact for any problems.
was redundant with text in the Porter's Handbook. Add text about what
portmgr is supposed to do. Provide links to documentation that needs
to be changed. Mention the CVSup examples.
Reviewed for content by: pav
a bit more than "an hour or two".
- The explenation of what needs approval and what not, during
a freeze was ambiguous, so clarify that all patches need
approval during a freeze.
While here:
- Add some links to the Portmgr Quality Assurance page.
- Use "the ports management team" instead of "the ports
manager" as we're more than one person and have been
for quite a while.
Reviewed by: marcus, krion
Approved by: remko
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>
speed up commits, avoid locking parts of the CVS tree for a very
long time and lets the committer take his time when writing the
commit message.
Hopefully, this way the quality of commit messages is easier to
control and we'll save ourselves some of the problems that can
result from hickups of the CVS repo-locking mechanism.
Approved by: re (Hiroki Sato)
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
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)
ports collection. One step is not yet defined; hopefully this will be
resolved soon.
PR: docs/64144
Reviewed by: eik and many others
Approved by: ceri (mentor)
- Remove the requirement for mentors to send PGP keys of new
committers to admins@.
committers-guide/article.sgml:
- Update copyright year.
- Emphasize that new committers should add their PGP key to the
Handbook, since it might be needed for identification, e.g. for
account recovery.
teams.ent:
- Add an entiry for admins@.
Discussed with: admins (joe, kensmith)
- 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.
- Don't join trademarks with other words, e.g. using hyphens.
trademark.ent:
- Commonly used trademarks are defined as entities for ease of use.
- All trademark attributions are defined as entities for ease of use.
Approved by: ceri (mentor)
CVS operations, where it fits slightly better.
Note to translators: I have tried to be sensitive to whitespace here, but it
has proved to be quite difficult in both this and the last revision. Apologies
in advance.
In reality, it is pretty close to Tier-1, but there are still a few
loose ends that need to be taken care of before locking down ABIs etc.
It was actually included in 5.1-RELEASE and it now has pre-built ports
packages etc.
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$.
o doc committers are also the group primarily responsible for www/
o Update an outdated example GNATS categories file
o Point a link to the Staff list at the Staff list
o Remove the text associated with the "Don't Touch The Repo" Rule
o Update references within the Big List of Rules
