Date: Sat, 24 May 2008 09:04:47 +0200 From: "Gabor PALI" <pgj@FreeBSD.org> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/123948: [patch] Fix Markup in FAQ, Question 3.14 Message-ID: <4837be11.0d135e0a.4cae.ffffdeb9@mx.google.com> Resent-Message-ID: <200805240710.m4O7A9la033885@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>Number: 123948
>Category: docs
>Synopsis: [patch] Fix Markup in FAQ, Question 3.14
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: doc-bug
>Submitter-Id: current-users
>Arrival-Date: Sat May 24 07:10:09 UTC 2008
>Closed-Date:
>Last-Modified:
>Originator: Gabor PALI
>Release: FreeBSD 6.3-STABLE i386
>Organization:
>Environment:
System: FreeBSD disznohal 6.3-STABLE FreeBSD 6.3-STABLE #4: Fri Apr 4 23:29:43 CEST 2008 dezzy@disznohal:/usr/obj/usr/src/sys/GENERIC_ i386
>Description:
I found missing <replaceable> tags in the FreeBSD FAQ, Question 3.14.
``Which geometry should I use for a disk drive?'' in the description
where it discuss about the geometry of SCSI disks. Text references
to a meta-value called M and it has a misused markup at the first
time (<literal> instead of <replaceable>) and then it is missing (no
markup). I think M should enclosed by <replaceable> tags both times
to fix this tiny problem.
>How-To-Repeat:
>Fix:
--- books.faq.patch.9.diff begins here ---
Index: book.sgml
===================================================================
RCS file: /doc/en_US.ISO8859-1/books/faq/book.sgml,v
retrieving revision 1.811
diff -u -r1.811 book.sgml
--- book.sgml 12 Apr 2008 20:13:12 -0000 1.811
+++ book.sgml 24 May 2008 03:27:20 -0000
@@ -1677,9 +1677,9 @@
<para>If it <emphasis>is</emphasis> turned on (it is often
supplied this way to get around certain limitations in
- &ms-dos;) and the disk capacity is more than 1GB, use M
+ &ms-dos;) and the disk capacity is more than 1GB, use <replaceable>M</replaceable>
cylinders, 63 sectors per track (<emphasis>not</emphasis>
- 64), and 255 heads, where <literal>M</literal> is the disk capacity in MB
+ 64), and 255 heads, where <replaceable>M</replaceable> is the disk capacity in MB
divided by 7.844238 (!). So our example 2GB drive would
have 261 cylinders, 63 sectors per track and 255
heads.</para>
--- books.faq.patch.9.diff ends here ---
>Release-Note:
>Audit-Trail:
>Unformatted:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?4837be11.0d135e0a.4cae.ffffdeb9>