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
- Use an entity to consistently type 'nVidia' with the right
capitalization (which also 'hides' the weird capitalization
from igor, and fixes some of its warnings).
- Capitalize section titles correctly
- Reindent some tags that were mis-aligned with their parent.
Approved by: gjb (mentor)
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@
- Documentation is updated from DocBook 4.1/SGML to DocBook 4.2/XML
- Webpages are updated from HTML 4.01 Transitional to XHTML 1.0 Transitional
- Static webpages are now processed by XSLT behind the scenes
- Webpages are now built with less cycles; tidy has been removed and the
date processing is now done by XSLT
- Generated webpages are now actually valid (they did not use to be)
- All XSLT stylesheets now pull in a main XSLT, which reduces
duplicated markup
- Site map and index are converted to an XML format with an
XSLT transformation that generates the output
- For docs, there is now only one entity set for both articles and books
- Some trademark/legalnotice entities have been merged to a cohesive
single entity file
- Untranslated entity sets are now always pulled in from the English tree
instead of redundant copies
- The base and enbase entities are already automatically generated so
remove inline definitions from individual files
- Fetch the LEGAL file via http instead of depending on CVS
- Convert id names to lowercase to avoid mixing different styles and
for better readability
- All PSGML comments are removed since they are mostly useless
- Convert character entities to normal characters
- Do not copy CSS files but override only necessary part
- Fix build with newest tidy
- Partly update the fdp-primer to reflect changes
Approved by: doceng (implicit)
