- combine the 'how to contribute' doc and the 'contributing to ports' doc.
- modernize the 'contributing to ports' doc
- use &os;
- prefer poudriere to tinderbox
Reviewed by: crees, bapt, mat
No objections from: bdrewery, gavin, wblock
- remove article about releng packages
- we no longer produce multi-cd releases
- CVS is not our VCS system
- we havn't releaseed with xfree86 is years
- section 1 about the 'ports cluster' is now entirely untrue and
been disclaimed by portmgr
Discussed with: peter, bdrewery, Daniel O'Connor
If I understand correctly the build broke because the non-english articles
import from the english version of fbsd-from-scratch.
Remove the translated articles for the articles I removed in English
- Replace /XML/{doc,www}/ with /XML/ in SysId.
- Remove empty stylesheets in share/xsl and point share/xml/empty.xsl via
XML catalog instead.
- Change the L10N layer in freebsd-*.xsl not to use localized XSLT
stylesheets directly.
- Move share/xsl/* to share/xml and remove share/xsl.
- Remove obsolete share/web2c/pdftex.def.
now picked up via share/xsl/*.xsl and they are empty when there is no
localized content in it. This prevents inconsistency between share/xsl/*.xsl
and the localized ones.
picked up via XML catalog in freebsd50.ent or xhtml10-freebsd.dtd,
not entities.ent. The L10N entities always come first to be able to
override everything.
- Define as   in EUC-JP encoding. This is a workaround to
prevent an invalid character in EUC-JP caused by converting 0xa0 in
UTF-8 (EUC-JP does not allow 0xa0) in XSLT processing. Theoretically
it should be   still in the final XML output.
- Make XML catalog resolution consistent for l10n.ent. This should be
revisited for the others later.
element but into a deeper paragraph, optimally right after the
referenced word without spaces even [1] but somehow the schema allows
badly nested indexterms. Correct such entires in the whole documentation
set.
- Add constraints to check for invalid indexterm entries.
See also: http://www.sagehill.net/docbookxsl/GenerateIndex.html#Indexterms [1]
The primary purposes are to clean up duplicated author definitions in
both share/xml/authors.ent and share/xml/developers.ent, and as a added
bonus simplify writing up author names/email addresses in web pages.
Apart from merging developers.ent into authors.ent, removing the former,
and updating the Committers Guide there should be little user-visible changes:
- a.portmgr renamed to a.portmgr.members
- a.doceng renamed to a.doceng.members
- team.re renamed to a.re.members.email and moved from
share/xml/freebsd.ent to share/xml/authors.ent
- a.core updated and moved from share/xml/mailing-lists.ent to
share/xml/teams.ent
- share/pgpkeys/{addkey.sh|README} updated
Translations are untouched except for build fixes.
Approved by: doceng (gjb)
Approved by: gjb (mentor)
converted to DocBook 5.0. This results in an ugly markup at some parts
but this can be corrected after the conversion is done. Anyway, these
sections need serious rewriting.
- Fix a double application element
done with Handbook and building pdf directly does not seem to work
correctly anyway. This change will help simplifying the build process
and spare some image conversions.
properly with xsltproc and the latter is simpler
- Add a constraint to prevent using screenco, programlistingco and
graphicco in the future
- Note that mediaobjectco is used in the documentation to properly
compose a figure element but the callout bugs are already there
in the source image and not placed there by the stylesheets
newer libxslt which check the stylesheet syntax more strictly.
|It is an error for the value of either the use attribute or the match
|attribute to contain a VariableReference.
| (XSL Transformations (XSLT) Version 1.0, Section 12.2)
this was that 'SGMLFLAGS' had to be changed to 'XMLFLAGS' in
share/mk/doc.docbook.mk so that everything continued to build OK.
Approved by: gabor (mentor)
much better ways of doing this in modern web browsers. Furthermore, it
never worked as well as it should have done, as too much of the website is
built around fixed layouts.
It was felt it was best to remove the size switcher from all languages at
once, so that the infrastructure (styleswitcher.js etc.) could be removed
at the same time.
Discussed at: Cambridge DevSummit, August 2012
Discussed on: www@
Approved by: gabor (mentor)
reasonable to maintain the reference, use the archived docs.
5-roadmap
checkpoint
dialup-firewall
diskless-x
euro
formatting-media
hats (content moved to htdocs/internal)
multi-os
storage-devices
vinum
zip-drive
All of these articles can be found here:
http://docs.freebsd.org/doc/9.0-RELEASE/usr/share/doc/freebsd/en_US.ISO8859-1/articles/
No objection from: doc@, www@
