- Revise wording of some sentences
- Use <acronym> and <filename> tags
- Follow FDP on continuous repetition of &man.command.#;
- Write out numbers under 10
- Show an example of complete output of "ls -l" command
- Mention after successfully logging in, you will see the MOTD, and
the command prompt
- Remove misleading comment about how chmod ### can only "set and
assign" permissions, but not remove them.
- "CPU time evenly to each user" -> "CPU time fairly to each user"
- "permissions stored as two octets" -> "permissions stored as three
octets"
Sponsored by: FreeBSD Mall, Inc.
- possessive form it's -> its
- add serial commas
- remove an erroneous "for"
- kstash was renamed to k5stash on pre 5.X systems
- s/Kerberized/kerberized/
- Tell the reader he should ask The Mathworks for a native version
- Add more infos about Java support.
In SAP section:
- Add and remove wrong application & command tags
- more s/I/we and contractions removal
PR: docs/57025 [1]
Submitted by: Dan Pelleg <daniel+handbook@pelleg.org>
chapter. This information is repeated in more basic terms in the
Install chapter, so this more in depth explanation is better suited in
Basics.
Sponsored by: FreeBSD Mall, Inc.
(driver tested on i386 and sparc64 platforms)
- minor formatting fixes (add <example></example>)
- minor spelling/grammar fixes
Approved: blackend (mentor)
- Remove the text about keeping the trademark list in doc/ and the one
in www/ synchronized. The doc/ trademark list is too big, so it's
better just to add the needed trademark attributions in the www/
trademark file.
- Add a missing period in the VMware trademark attribution.
- Sort the entries in this file; somebody pass me an alphabet.
- Add missing username, command, application and filename tags
- Remove useless '-'
- s/export/EXPORT for consitency
- s/I/We, s/my/our
- Some little rewordings (well the content is often disappointing, but
I'm unable to do tests)
Mention:
- this chapter is a general guide, not a literal reference manual
- what partition types PResizer, FIPS, and PartitionMagic deal with
- subnet mask as a requirement to configure Ethernet interface
- most computers can boot from CDROM/DVD drive
- Windows does not report bad blocks when formatting floppies
- BIOS "list of devices" is commonly known as "Boot Order"
- If old OS loads, BIOS may not support boooting from desired media
- use of "U"ndo in FDisk Editor
- one needs to change their Keymap only if they're using a
non-standard keyboard
- in FDisk Editor, when hitting 'C', default value is the largest
available block
- BootMgr needs to be installed on both disks 1 and 2 if FreeBSD is
being installed on disk 2
- how much space the FreeBSD Ports Collection uses
- purpose of NFS client
- how an improper X configuration can freeze the machine/installation
- how to "Cancel" out of the Package installer
- C-shell (example uses bash)
Remove:
- extranneous words
- periods after list of information required to configure Ethernet and
PPP interfaces
- mention that there is "always" conflicts in UserConfig
Change:
- "installation routine will prompt you several times before writing
any data to disc" -> ... "will prompt you before" ...
There's only one real FINAL warning
- "Skip to the next section" -> "skip this section"
- "Irrespective of whether" -> "Whether"
- "Newer devices..., and be" -> "Newer devices..., and are"
- "A tape" -> "SCSI or QIC tape"
- <important> -> <warning> in some cases
- Its -> it's in some cases
- "/var directory contains varible length files" -> ... "contains
files that are constantly varying"
- Network File Service -> Network File System
- optimise -> optimize
- "then asked" -> "then be asked"
- FreeBSD 3.4 -> FreeBSD &rel.current;
- partition ID 165 -> partition ID of 165
* Insert many commas and remove many others
* Include a link to the latest FreeBSD errata page
* Make use of &ms-dos and &windows entities
* Make use of <filename class="directory"> tags
* Properly markup some <acronym>'s
* Explain when one would use Standard or None as their boot manager
* Clarify when to use IPv6 auto-detection
* Make use of <hostid> tags
* Clarify testing the mouse daemon during configuration
* Remove repeated content about creating installation floppies in
* Advanced Installation section
* Use /floppy when example mounts a floppy
* Remove mention of CDROMs #3-5, since the project no longer publishes them
* Remove mention of how the mini-ISO was not produced prior to 4.4
* Many other minor technical and English clarifications
Sponsored by: FreeBSD Mall, Inc.
the lines at column 90, instead of the default 68. This makes the
resulting HTML considerably smaller.
The change also band-aid a problem where Tidy wrap lines which shouldn't
have been wrapped. This can cause extra spaces in the resulting HTML,
e.g. resulting in "( audio/lame)" instead of "(audio/lame)".
Discussed on: -doc
handbook to allow it to be incorporated in the build. This is not on by
default at the moment, and users who want it will need to set WITH_GLOSSARY
to a non-empty string when building ("make WITH_GLOSSARY=yes" being the
common case).
It is expected that committers will help to flesh out the glossary before
it is connected to the build by default; the current entries have been chosen
to illustrate the way that DocBook allows for "See also" and "See" in the
glossary elements.
This commit also takes the index out of the appendices in the handbook, as
this is not the usual place for an index to sit in a book, and moves it to
the end of the book.
- 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").
required symbols, by setting the make variable
WITH_ALL_TRADEMARK_SYMBOLS, to any non empty value.
This feature is mainly useful for document writers, to make sure all
trademarks are marked up correctly.
- Use trademark entities
- Add trademark attributions.
- Always use correct case for trademarks.
- Don't join trademarks with other words, e.g. using hyphens.
trademark.ent:
- Add entities for more trademarks / companies.
- Sort the Sun trademark attribution entity.
- Various punctuation fixes
- Use of application, literal, acronym tags where needed
- s/I/We
- s/id/ID to be consistent with the rest of docs
- Some "little rewordings".
