os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity
41953 commits 1 branch 79 tags 298 MiB
Commit graph

130 commits

Author SHA1 Message Date
Gabor Kovesdan
888db9ae19 - MFH 2013-07-11 17:27:09 +00:00
Gabor Kovesdan
71c8436054 - Whitespace adjustments after last commit 2013-07-11 17:11:21 +00:00
Gabor Kovesdan
b0b78fa4e9 - Indexterms should not be embedded directly into a question or answer 
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]
 2013-07-11 16:34:54 +00:00
Gabor Kovesdan
d31228bd31 - MFH 2013-07-06 15:14:42 +00:00
Gabor Kovesdan
0dcb7a2f33 - Avoid footnotes in tables; it looks strange and is problematic for 
some tools. (Either removed if the affected text has been removed
  from the English version or moved into parentheses.)
- Add constaints to avoid programlisting, screen and footnote in tables.
 2013-07-06 14:05:02 +00:00
Gabor Kovesdan
57cba96872 - MFH 2013-07-04 19:03:44 +00:00
Gabor Kovesdan
e819151e45 - Fix the cases when the specified column number does not match the real one 
- Add a constraint for this
 2013-07-03 17:35:46 +00:00
Gabor Kovesdan
fc03eb5c00 - MFH 2013-07-03 10:43:17 +00:00
Marc Fonvieille
a25bf53760 Add id attribute to legal notices to prevent filenames with 
auto-generated names.  This will help to track built/installed files
and will ease the packages managing.

Approved by:	doceng (implicit)
 2013-06-30 15:08:46 +00:00
Gabor Kovesdan
3e709957a1 - Do not enclose manpage entities into application 2013-06-20 18:21:26 +00:00
Gabor Kovesdan
aa74e030ad - Properly refer to the glossary 2013-06-20 16:51:23 +00:00
Gabor Kovesdan
cdfb9c36e5 - Convert glossary to normal include file instead of entity so that it can be 
transformed with XSLT
 2013-06-20 16:39:11 +00:00
Gabor Kovesdan
754ee39226 - Eliminate double application element 2013-06-20 16:22:38 +00:00
Glen Barber
b648b634f6 Fix syntax from previous commit. 2013-06-18 02:08:55 +00:00
Glen Barber
21dae225c8 Fix build with bmake(1). 
Approved by:	doceng (implicit)
 2013-06-18 00:49:02 +00:00
Gabor Kovesdan
c1176e6ec9 - Add namespace declarations and convert entities to DB 5.0 2013-06-11 09:59:34 +00:00
Gabor Kovesdan
29b0776d82 - Add namespace declaration to trademark entities 2013-06-10 11:36:54 +00:00
Gabor Kovesdan
9b83da790c - Revert r41880 and r41881 since they resulted in loss of semantic 
information

Pointed out by:	hrs
 2013-06-10 09:40:37 +00:00
Gabor Kovesdan
af9e52a7e6 - Avoid trademark in application 2013-06-08 17:27:35 +00:00
Gabor Kovesdan
d0265dd398 - Clean up unused trademark entities 2013-06-08 17:03:03 +00:00
Gabor Kovesdan
e731b1f9a7 - Remove type="html" from ulink 2013-06-03 12:41:52 +00:00
Gabor Kovesdan
c94df498ed - Drop SGML catalogs 
- Drop DSSSL stylesheets
- Drop some DSSSL-related comments and Makefile code
 2013-05-29 19:21:25 +00:00
Gabor Kovesdan
a6684b4306 - Reduce the misuse of role attribute; role="directory" should actually be 
class="directory"
- Add constraint to enforce this
 2013-04-04 11:40:58 +00:00
Gabor Kovesdan
e8e2dfdbab - Do not specify image file extensions in documents; the proper extension 
is appended during rendering
- For the same reason, do not specify format either
- Add constraints to enforce this
 2013-04-02 09:50:10 +00:00
Gabor Kovesdan
c8eadc3369 Always build pdf from ps and remove related nits. This is what was already 
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.
 2013-03-31 21:11:07 +00:00
Gabor Kovesdan
a1f0eaf271 - Place the footer below the navigation as it used to be 2013-03-15 08:06:33 +00:00
Gabor Kovesdan
eb47c46865 - Fix erroneous fileref's that result in missing images 
- Also fix fdp-primer examples
 2013-03-14 09:19:23 +00:00
Gabor Kovesdan
998b28cb3e - Add more customization layers 
- Localize footers
 2013-02-26 09:43:12 +00:00
Gabor Kovesdan
0701bf45bd - Add infrastructure for language-specific XSLT customizations 2013-02-25 20:17:26 +00:00
Gabor Kovesdan
f5b13d3d30 - Clean up more DSSSL leftovers 2013-02-19 17:08:14 +00:00
Gabor Kovesdan
59d4db9584 - Add back SGML catalogs (trimmed to minimally necessary content) since 
they are still needed for language-specific DSSSL customizations
 2013-02-19 16:14:00 +00:00
Gabor Kovesdan
a06603e1e8 - MFH 2013-02-05 09:14:34 +00:00
Gabor Kovesdan
3327cf64d4 - Remove HTML Tidy leftovers 2013-02-01 18:51:52 +00:00
Gabor Kovesdan
a3c89a1805 - Use exclusively the XML catalogs and drop the old SGML format 2013-02-01 09:48:25 +00:00
Gabor Kovesdan
af7381742b - Move language-independent entities directly to the DTD 2013-02-01 09:03:01 +00:00
Gabor Kovesdan
d891a25dc5 - Make sure all source files are ready before validation 
- Make sure all source files are ready before building
- Clean up the workarounds from handbook Makefiles
 2013-01-31 09:55:07 +00:00
Gabor Kovesdan
5df509eaa2 - Remove standalone="no" statements from XML declarations since it did not 
always work and is no use anyway
 2013-01-30 19:12:36 +00:00
Gabor Kovesdan
36cdb51546 - Migrate the documentation set to DocBook 4.5 2013-01-30 14:00:53 +00:00
Gabor Kovesdan
1e99c6f9de - Make the Italian documentation valid XML 2013-01-21 17:39:52 +00:00
Gabor Kovesdan
5086b7db96 - Fix the make lint (validate) target 2012-10-13 18:32:14 +00:00
Isabell Long
2be1e25fc2 Replace 'SGML' with 'XML' in Makefile code and comments. A consequence of 
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)
 2012-10-06 17:52:37 +00:00
Gabor Kovesdan
77d737ee88 - Rename the share/sgml directories to share/xml 
- Fix build errors from the next change

Approved by:	doceng (implicit)
 2012-10-01 11:56:00 +00:00
Gabor Kovesdan
b4346b9b2d - Rename .sgml files to .xml 
- Reflect the rename in referencing files

Approved by:	doceng (implicit)
 2012-10-01 09:53:01 +00:00
Isabell Long
bee5d224fe Remove the ability to change the font size on the website. There are now 
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)
 2012-09-30 13:27:05 +00:00
Gabor Kovesdan
efe7023c1f - Encoding names should be IANA names and in lower case 2012-09-22 20:09:08 +00:00
Gabor Kovesdan
9b85c2d7f5 - Remove old web content and references to them 
Discussed with:	doc@, www@
 2012-09-22 19:20:16 +00:00
Gabor Kovesdan
d8a2cdf09b - Remove the following articles and references to them. Where it is 
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@
 2012-09-20 14:33:30 +00:00
Gabor Kovesdan
9c243757ef - XML declarations should use IANA encoding names 
Pointed out by:	hrs
 2012-09-14 17:47:48 +00:00
Alex Dupre
38a3931f23 Update Italian web site (home page & menu). 2012-09-14 16:05:20 +00:00
Gabor Kovesdan
b0de170035 - Fix translated entities by Properly overriding l10n.ent in the catalog chain 
Approved by:	doceng (implicit)
 2012-08-30 17:41:56 +00:00