docs/56231: [PATCH] correct few tags in doc/en_US.ISO8859-1
Denis Peplin
den at freebsd-doc.org.ru
Sun Aug 31 11:40:19 UTC 2003
>Number: 56231
>Category: docs
>Synopsis: [PATCH] correct few tags in doc/en_US.ISO8859-1
>Confidential: no
>Severity: serious
>Priority: medium
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: doc-bug
>Submitter-Id: current-users
>Arrival-Date: Sun Aug 31 04:40:13 PDT 2003
>Closed-Date:
>Last-Modified:
>Originator: Denis Peplin <den at freebsd-doc.org.ru>
>Release: FreeBSD 5.1-RELEASE i386
>Organization:
Non-official FreeBSD Russian Documentation Priject
>Environment:
System: FreeBSD name.local 5.1-RELEASE FreeBSD 5.1-RELEASE #2: Sat Aug 2
10:45:08 GMT 2003 root at name.local:/usr/obj/usr/src/sys/HOME i386
>Description:
>How-To-Repeat:
this is a bit buggy/dirty script produce diags that can help to
find not closed tags.
#!/usr/local/bin/perl
use File::Find;
$path = "/4/usr/home/den/temp/doc/en_US.ISO8859-1/";
$show_linelook = 1; # can be helpful when other methds fails
$linelook_all = 1; # show line even if tag is not alone
$tagignore = "xref anchor graphic imagedata colspec spanspec structfield";
$tagignore.= "co inlinegraphic URL EOM "; # from <programlisting>
$tagignore.= "hr br b h2 p td font"; # html tags
find(\&wanted, $path);
sub wanted {
if (-f && /^.*\.sgml$/ ) {
print "$File::Find::name\n";
#check_para($_);
check_pairs($_);
}
}
sub check_pairs {
my($file) = @_;
open(DOC_SGML, $file)
or die "Can't open file: $!\n";
$line=0;
undef %count;
undef %warnlines;
undef %lastline;
undef %linelook;
undef %lineprev;
undef %warnsame;
while (defined ($_ = <DOC_SGML>)) {
$line++;
next if /^[ \t]*<!--.*-->$/; # can skip only whole line comment
next if /^[ \t]*<!--.*$/ && ! /-->/;
next if ! /<!--/ && /^.*-->$/;
next if /^<!ENTITY[^>]*>$/;
while (/<([A-Za-z][a-zA-Z0-9]+)( [^<]*|[^<@]*)(>|$)/g) {
next if $tagignore =~ $1;
$tagname=$1;
$count{$1}++;
$lastline{$1} = $line;
if ($count{$1} > 2) {
$warnlines{$1}=$warnlines{$1}."$line<$count{$1}> ";
}
if ($linelook_all || /^[ \t]*<$tagname>$/) {
$countprev = $count{$tagname} - 1;
$linepad = sprintf("%04d", $line);
if ($lineprev{$tagname} eq $_) {
$warnsame{$tagname} .= "$linepad ";
}
$lineprev{$tagname} = $_;
$linelook{$tagname} .= "$linepad:$countprev:$_";
}
}
while (/<\/([A-Za-zA-Z0-9]+)>/g) {
next if $tagignore =~ $1;
$tagname=$1;
$count{$1}--;
if ($count{$1}) {
$warnlines{$1}=$warnlines{$1}."$line>$count{$1}< ";
}
if ($linelook_all || /^[ \t]*<\/$tagname>$/) {
$linepad = sprintf("%04d", $line);
if ($lineprev{$tagname} eq $_) {
$warnsame{$tagname} .= "$linepad ";
}
$lineprev{$tagname} = $_;
$linelook{$tagname} .= "$linepad:$count{$tagname}:$_";
}
}
}
close(DOC_SGML);
print "\n";
$error = 0;
while (($key, $val) = each %count) {
if ($val != 0) {
$error = 1;
print $linelook{$key} if $show_linelook;
print "$key=$val\nlast: $lastline{$key}\n";
print "Warn:\n$warnlines{$key}\n";
print "Same lines detected at:\n$warnsame{$key}\n";
print "------------------------------------------";
print "\n";
}
}
if ($error) {
exit;
}
}
>Fix:
diff --exclude=CVS -u -r
/4/usr/home/den/temp/old/doc/en_US.ISO8859-1/articles/releng-packages/article.sgml
/4/usr/home/den/temp/doc/en_US.ISO8859-1/articles/releng-packages/article.sgml
---
/4/usr/home/den/temp/old/doc/en_US.ISO8859-1/articles/releng-packages/article.sgml
Sun Sep 8 01:01:42 2002
+++
/4/usr/home/den/temp/doc/en_US.ISO8859-1/articles/releng-packages/article.sgml
Sun Aug 31 14:40:44 2003
@@ -238,7 +238,7 @@
<listitem><para>Grab a copy of <filename>ports.tar.gz</filename>
and extract it into the <filename>ports</filename> directory
alongside
<filename>doit.sh</filename> and the
- <Filename>scripts</filename> directory.</para></listitem>
+ <filename>scripts</filename> directory.</para></listitem>
<listitem><para>Remove the packages/distfiles directories or
symlinks. Bento has these as symlinks and you will have mixed
@@ -299,7 +299,7 @@
<para>After going through this the first time if you are lucky
enough that all of the required packages built and fit on each
disc. All you need to do is set <varname>fake</varname> to 0 in
- <Filename>oneshot.pl</filename> and re-run
+ <filename>oneshot.pl</filename> and re-run
<command>./doit.sh</command>. The second and subsequent times
around it will skip steps 1-5 above. If you want to re-run any
of those steps refer to <filename>doit.sh</filename> for which files
diff --exclude=CVS -u -r
/4/usr/home/den/temp/old/doc/en_US.ISO8859-1/books/arch-handbook/mac/chapter.sgml
/4/usr/home/den/temp/doc/en_US.ISO8859-1/books/arch-handbook/mac/chapter.sgml
---
/4/usr/home/den/temp/old/doc/en_US.ISO8859-1/books/arch-handbook/mac/chapter.sgml
Sun Aug 31 15:06:13 2003
+++
/4/usr/home/den/temp/doc/en_US.ISO8859-1/books/arch-handbook/mac/chapter.sgml
Sun Aug 31 14:46:30 2003
@@ -3236,7 +3236,7 @@
<paramdef>struct ifnet
*<parameter>ifnet</parameter></paramdef>
<paramdef>struct label
- *<parameter>ifnetlabel</parameter></paramdeF>
+ *<parameter>ifnetlabel</parameter></paramdef>
</funcprototype>
</funcsynopsis>
diff --exclude=CVS -u -r
/4/usr/home/den/temp/old/doc/en_US.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml
/4/usr/home/den/temp/doc/en_US.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml
---
/4/usr/home/den/temp/old/doc/en_US.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml
Sun Jul 20 20:55:18 2003
+++
/4/usr/home/den/temp/doc/en_US.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml
Sun Aug 31 14:41:01 2003
@@ -1897,7 +1897,7 @@
<filename>/dev/ttyd0</filename> and <filename>/dev/cuaa0</filename>.</para>
<para>By contrast, the networking devices, such as
- <devicename>ed0</devicename> do not appear in <filename>/dev</filename>.
+ <devicename>ed0</devicename> do not appear in
<filename>/dev</filename>.</para>
<para>In MS-DOS, the first floppy drive is referred to as
<devicename>a:</devicename>. In FreeBSD it is
diff --exclude=CVS -u -r
/4/usr/home/den/temp/old/doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgml
/4/usr/home/den/temp/doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgml
---
/4/usr/home/den/temp/old/doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgml
Sat Aug 23 23:26:43 2003
+++ /4/usr/home/den/temp/doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgml
Sun Aug 31 14:41:01 2003
@@ -698,6 +698,7 @@
<screen>&prompt.root; <userinput>atacontrol attach 3</userinput>
Master: ad6 <MAXTOR 6L080J4/A93.0500> ATA/ATAPI rev 5
Slave: no device present</screen>
+ </step>
<step>
<para>Rebuild the array:</para>
@@ -2456,6 +2457,7 @@
<para>For more details, please refer to &man.md.4; manual
page.</para>
+ </sect2>
<sect2 id="disks-md-freebsd5">
<title>Memory-Based File System under FreeBSD 5.X</title>
@@ -3191,6 +3193,7 @@
it is recommended that such scripts be run manually while
providing the password via the console or &man.ssh.1;.</para>
</sect3>
+ </sect2>
<sect2>
<title>Cryptographic Protections Employed by gbde</title>
diff --exclude=CVS -u -r
/4/usr/home/den/temp/old/doc/en_US.ISO8859-1/books/handbook/linuxemu/chapter.sgml
/4/usr/home/den/temp/doc/en_US.ISO8859-1/books/handbook/linuxemu/chapter.sgml
---
/4/usr/home/den/temp/old/doc/en_US.ISO8859-1/books/handbook/linuxemu/chapter.sgml
Sun Aug 31 15:06:28 2003
+++
/4/usr/home/den/temp/doc/en_US.ISO8859-1/books/handbook/linuxemu/chapter.sgml
Sun Aug 31 14:41:01 2003
@@ -2793,6 +2793,7 @@
<entry>Name</entry>
<entry>Value</entry>
</row>
+ </thead>
<tbody>
<row>
<entry>ztta/dynpro_area</entry>
@@ -2811,6 +2812,7 @@
<entry>Name</entry>
<entry>Value</entry>
</row>
+ </thead>
<tbody>
<row>
<entry>rdisp/ROLL_MAXFS</entry>
diff --exclude=CVS -u -r
/4/usr/home/den/temp/old/doc/en_US.ISO8859-1/books/handbook/mail/chapter.sgml
/4/usr/home/den/temp/doc/en_US.ISO8859-1/books/handbook/mail/chapter.sgml
---
/4/usr/home/den/temp/old/doc/en_US.ISO8859-1/books/handbook/mail/chapter.sgml
Sat Aug 2 12:31:57 2003
+++ /4/usr/home/den/temp/doc/en_US.ISO8859-1/books/handbook/mail/chapter.sgml
Sun Aug 31 14:41:01 2003
@@ -604,6 +604,7 @@
<application>sendmail</application>'s startup options is
available from the &man.rc.sendmail.8; manual page.</para>
</sect3>
+ </sect2>
<sect2>
<title>Running Your New MTA on Boot</title>
diff --exclude=CVS -u -r
/4/usr/home/den/temp/old/doc/en_US.ISO8859-1/books/handbook/mirrors/chapter.sgml
/4/usr/home/den/temp/doc/en_US.ISO8859-1/books/handbook/mirrors/chapter.sgml
---
/4/usr/home/den/temp/old/doc/en_US.ISO8859-1/books/handbook/mirrors/chapter.sgml
Tue Aug 26 07:19:28 2003
+++
/4/usr/home/den/temp/doc/en_US.ISO8859-1/books/handbook/mirrors/chapter.sgml
Sun Aug 31 14:41:01 2003
@@ -4526,6 +4526,7 @@
<para>The line of development for FreeBSD-2.2.X, also known
as 2.2-STABLE. This branch is mostly obsolete.</para>
</listitem>
+ </varlistentry>
</variablelist>
</sect2>
diff --exclude=CVS -u -r
/4/usr/home/den/temp/old/doc/en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml
/4/usr/home/den/temp/doc/en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml
---
/4/usr/home/den/temp/old/doc/en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml
Sun Aug 31 15:06:28 2003
+++
/4/usr/home/den/temp/doc/en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml
Sun Aug 31 14:41:01 2003
@@ -1092,6 +1092,7 @@
design. However, once
you get used to the command line options and the key-stroke
controls, it works very well.</para>
+ </sect4>
<sect4 id="video-mplayer-building">
<title>Building MPlayer</title>
diff --exclude=CVS -u -r
/4/usr/home/den/temp/old/doc/en_US.ISO8859-1/books/handbook/security/chapter.sgml
/4/usr/home/den/temp/doc/en_US.ISO8859-1/books/handbook/security/chapter.sgml
---
/4/usr/home/den/temp/old/doc/en_US.ISO8859-1/books/handbook/security/chapter.sgml
Tue Aug 26 07:19:28 2003
+++
/4/usr/home/den/temp/doc/en_US.ISO8859-1/books/handbook/security/chapter.sgml
Sun Aug 31 14:41:01 2003
@@ -3182,6 +3182,7 @@
role="ipaddr">W.X.Y.Z</hostid> it will need to
<quote>unencapsulated</quote>, and delivered to <hostid
role="ipaddr">192.168.2.1</hostid>.</para>
+ </listitem>
</orderedlist>
<para>You can think of this as requiring a <quote>tunnel</quote>
diff --exclude=CVS -u -r
/4/usr/home/den/temp/old/doc/en_US.ISO8859-1/books/handbook/vinum/chapter.sgml
/4/usr/home/den/temp/doc/en_US.ISO8859-1/books/handbook/vinum/chapter.sgml
---
/4/usr/home/den/temp/old/doc/en_US.ISO8859-1/books/handbook/vinum/chapter.sgml
Sun Jul 13 20:36:54 2003
+++ /4/usr/home/den/temp/doc/en_US.ISO8859-1/books/handbook/vinum/chapter.sgml
Sun Aug 31 14:41:01 2003
@@ -1110,6 +1110,7 @@
<listitem>
<para>The root volume must not contain more than one
concatenated subdisk per plex.</para>
+ </listitem>
</itemizedlist>
<para>Note that it is desirable and possible that there are
>Release-Note:
>Audit-Trail:
>Unformatted:
More information about the freebsd-doc
mailing list