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

76 commits

Author SHA1 Message Date
Eitan Adler
e472e8e8bd new users: 
Stop assuming people have experience with DOS or OS/2:
	Some time in the last couple of years this experience
	ceased to be common place.
 2015-04-03 15:18:19 +00:00
Eitan Adler
b60839cd34 new users: 
Remove steps which are no longer required.
	- rehash is taken care of by autorehash
	- shells is modified when the package is installed
 2015-04-03 15:12:06 +00:00
Eitan Adler
d525a81dc3 new users: 
it seems unlikely that users new to FreeBSD will want to do any of
		- use a floppy
		- use DOS
	and even using a tape drive and printing aren't common first tasks

	remove this section
 2015-04-03 15:02:31 +00:00
Eitan Adler
caa7a4afdf Direct new users to less(1) instead of view(1) 2014-06-30 04:09:25 +00:00
Warren Block
14d07bd15d Restore lost <replaceable> tags. 2014-04-29 02:41:28 +00:00
Hiroki Sato
8def749c53 Normalize DTD URL. 2013-11-13 07:52:45 +00:00
Gabor Kovesdan
24d129e8d1 - Definitively upgrade to DocBook 5.0 2013-11-07 15:39:28 +00:00
Gabor Kovesdan
dd160320f2 - MFH 2013-05-15 14:07:01 +00:00
Eitan Adler
a0f44093e0 Remove references to netscape from the new users article 
Approved by:	bcr (mentor)
 2013-05-12 03:14:27 +00:00
Eitan Adler
faa2719484 Remove more outdated information from the new users document. 
This article can do with some serious work.

Approved by:	bcr (mentor)
 2013-05-12 03:13:05 +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
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
Gabor Kovesdan
9c243757ef - XML declarations should use IANA encoding names 
Pointed out by:	hrs
 2012-09-14 17:47:48 +00:00
Gabor Kovesdan
2e51ec7022 - Strip unnecessary trailing spaces 
Approved by:	doceng (implicit)
 2012-08-21 19:16:02 +00:00
Gabor Kovesdan
e6b69c3357 - XMLify English articles 
Approved by:	doceng (implicit)
 2012-06-21 16:01:00 +00:00
Giorgos Keramidas
dfe9966e3f Using "mount -t msdos" is deprecated; the canonical name of the 
filesystem type is "msdosfs".  There has been some compatibility
glue in mount(8) to silently convert "mount -t msdos" to "mount
-t msdosfs" for a while now, but using the deprecated name may
cause errors when someone tries to "umount -t msdos".  The later
doesn't work at all.

Noticed by:	rodrigc, long ago
 2009-01-28 08:48:21 +00:00
Simon L. B. Nielsen
19619cea27 Set id attributes on sect1 to prevent x123.html style filenames for 
html-split output.
 2008-12-30 14:19:13 +00:00
Giorgos Keramidas
0d6633f7c0 Add a missing <command> element. 2008-11-30 16:20:17 +00:00
Marc Fonvieille
b2fbb31f74 Typo and punctuation fixes. 2006-08-29 07:38:23 +00:00
Hiroki Sato
c4cb2201ad Use lower-case characters for attribute name (s/URL=/url=/). 
No content change.
 2004-08-09 19:49:18 +00:00
Hiroki Sato
5fa082b1f8 Simplify parameter entities in doctype declaration. 
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.
 2004-08-08 13:44:01 +00:00
Denis Peplin
c12c11040e Use url entities for links between docs 2004-08-05 10:04:31 +00:00
Hiroki Sato
84f8ee0a15 Use relative URLs when URL_RELPREFIX is defined and URLS_ABSOLUTE 
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
 2004-07-06 15:09:55 +00:00
Denis Peplin
59859e64cb Close / fix pair tags 2004-07-06 14:25:55 +00:00
Denis Peplin
bf2a771582 Use &url.main; for references to main FreeBSD website 
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)
 2004-05-11 13:29:48 +00:00
Alexey Zelkin
6d048e2320 Sync these Makefiles to have one style of declarations and comments. 2004-04-06 16:10:08 +00:00
Ceri Davies
b06bc00794 Update the reference to Essential System Administration to the 3rd 
edition, which specifically covers FreeBSD.
 2004-01-22 20:25:51 +00:00
Ceri Davies
241bd76986 o s/dismount/unmount/ 
o Various grammatical changes
 2004-01-22 20:23:39 +00:00
Josef El-Rayes
4af34cdb02 Add <username> tags for root and fix some minor issues. 
Approved by:    simon(mentor)
Submitted by:   Lukas Ertl <l.ertl@univie.ac.at>
PR:             docs/54789
 2004-01-17 19:01:46 +00:00
Simon L. B. Nielsen
b8494fd2f5 - Use trademark entities. 
- Add trademark attributions.
- Don't join trademarks with other words, e.g. using hyphens.
- Don't use trademarks as nouns (e.g. don't use "Windows NT's").
 2003-09-18 15:32:54 +00:00
Marc Fonvieille
6e6d907ceb Missing/empty tags fixes. 
Found by:	make lint
 2003-08-27 07:13:11 +00:00
Ceri Davies
af00da4546 Correct some markup: 
o The full stop at the end of a sentence should not be placed within
	  a progamlisting element.

	o Break the programlisting out of the para element.
 2003-07-13 15:38:43 +00:00
Murray Stokely
00b824feeb Include FreeBSD default entities; 
Use &unix; for first two occurrences of the word.
 2003-06-17 21:04:23 +00:00
Hiroki Sato
f6cd99b654 Back out WITH_DOCFORMAT_NAVI_LINK?=YES in Makefile. The navi-link 
is generated when ${WITH_DOCFORMAT_NAVI_LINK} is defined or
${FORMATS} includes "html" and "html-split."
 2003-04-22 18:35:44 +00:00
Hiroki Sato
4f8b26641c - Add WITH_DOCFORMAT_NAVI_LINK to mk/doc.docbook.mk and 
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$.
 2003-04-19 11:39:30 +00:00
Tom Rhodes
d4b003e30a FreeBSD documentation project prefers to use manual pages over man pages, 
hence some documents should reflect this.

Tossed around on: -doc -developers
 2002-07-11 19:08:31 +00:00
Ceri Davies
496c9f72cc Remove duplicate words. 2002-05-28 17:46:25 +00:00
Tom Rhodes
9ba764ae23 Consistancy checks: s/file system/filesystem/g 2002-05-16 01:42:28 +00:00
Peter Pentchev
6e99166b51 Whitespace-only fixups from the e-mail to SGML entities conversion. 2002-03-15 08:28:14 +00:00
Peter Pentchev
81f0937cee Convert names, descriptions and e-mail addresses of FreeBSD committers 
and mailing lists to SGML entities.

Reviewed by:	keramida
Approved by:	keramida, silence on -doc
 2002-03-15 08:10:48 +00:00
Murray Stokely
720d4d69c8 * s/freebsd.org/FreeBSD.org/ 
* Correct some broken links
* Use relative links for freebsd.org documents

PR:		docs/31447
Submitted by:	Cyrille Lefevre <clefevre@citeweb.net>
Found by:	linbot
 2001-10-23 21:31:20 +00:00
Giorgos Keramidas
0b824da1aa Remove all contractions from most of the articles. This solves the 
problems with the usage of "its" vs "it's" among other things

Approved by:	nik
 2001-10-16 11:53:01 +00:00
Murray Stokely
c3b5bf8e85 Whitespace change only. Re-wrap paragraphs after previous commit. 2001-09-24 01:40:05 +00:00
Murray Stokely
71152126bb Add more precise markup : 
- man page entities
  - <command>
  - <username>
  - <groupname>
  etc..

PR:		docs/30657
Submitted by:	Giorgos Keramidas <charon@labs.gr>
 2001-09-24 01:32:07 +00:00
Murray Stokely
b338f4c086 * Add <filename> tags. 
* Use 'DOS', for Disk Operating System, consistently.

PR:		docs/30612
Submitted by:	Giorgos Keramidas <charon@labs.gr>
 2001-09-17 01:29:35 +00:00
Dima Dorfman
450cef3647 Consistently use &mdash; instead of '--'. 
PR:		30501
Submitted by:	Giorgos Keramidas <charon@labs.gr>
 2001-09-11 11:26:41 +00:00
Jeroen Ruigrok van der Werven
baf88189b9 Fix 404. Missed a books/ in URL. 
Submitted by:	checkbot
 2001-07-25 11:54:31 +00:00
Chern Lee
3e8d98b70a Standardize: 
TCL -> Tcl
ethernet -> Ethernet
ftp (noun) -> FTP

Approved by:	murray
 2001-07-17 22:20:51 +00:00