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
Repository Copy question on Porter's FAQ
o Reviewers wrote the committed version
Reviewed by: adamw, ceri, steve, tom,
"Gary W. Swearingen" <swear@attbi.com>,
Warren Block <wblock@wonkity.com>
Describe how to commit on ncvs.FreeBSD.org using remote CVS.
Add a note to NOT use the main repository host as your personal
cvs server, as inspired by peter's mail to developers@ a while back.
Refer to the cvsup distribution method and cvsup-master instead and
give an example of an "fcvs" alias, as suggested by many committers.
Reword or remove various paragraphs about not modifiying the repository
yourself, which is no longer possible, since only repomeisters have
access to ncvs.FreeBSD.org.
Remove the paragraph about CVSUMASK, which no longer applies.
