When SGML formatting fixes hit translators
Hi,
Just a sigh from a translator of the b-f documentation...
The release-notes.SGML CVS version 1.86 was another beautification of
the SGML code:"Fixed some formatting problems that seemed to have
creeped in." by robster. The same happened some time back in January.
E.g. paragraphs were indented one more character, line wraps were reset
and the look of the SGML code made more uniform. This is a very nice
service for people editing the SGML source.
But it creates a hell for translators carefully looking through diffs
e.g. from the doc-check script! See the appended (partial!) example.
Each time we have to manually compare the reformatted text word by word
to the old text in order not to leave out any important changes in the
contents.
Please think of us for a moment before submitting such patches (and
reformatting large paragraphs after deleting a word). I am sure that
robster had all the best intentions and were not at all aware of this
side effect when submitting the patch. Of course the SGML source should
not be allowed to grow completely ugly and unreadable. Any suggestions
on how to handle this problem (e.g. making doc-check more intelligent)
are of course very welcome,
Claus Hindsgaul
A sighing translator :-)
@@ -105,34 +105,33 @@
<p>This allows greater selection of tasks and it is much easier
to only install selected components of tasks, i.e. not the
whole thing.</p>
-
- <p>Debian 3.0 is much more secure that previous releases. The base
- installation provides fewer unnecessary services that might be the
- target of attack. Debian 3.0 includes many more security-oriented
- applications such as firewall administration, server hardening and
- intrusion detection. The packaging system has also been improved so it
- can be configured to automatically check digital signatures. When
- configured, it will refuse to install Debian packages if the digital
- signature doesn't match. This limits the possibility of trojan horse
- installation and makes it easier and safer for systems to
- automatically upgrade themselves over the Internet. Lastly, Debian now
- provides intensive documentation for the security-aware administrator
- including the <url
- id="http://www.debian.org/doc/manuals/securing-debian-howto";
- name="'Securing Debian Manual'"> from the Debian Documentation Project
- (also available in the <package/harden-doc/ package).</p>
-
- <p>Debian 3.0 is also much more <url
- id="http://www.debian.org/international";
- name="internationalized"> than previous releases thanks to
- the ongoing work of free software translation teams. Debian
- includes default settings for more languages than previous
- releases, and more of its programs are international-ready.
- This includes the boot-floppies installation which has been
- translated to a number of languages. There is extensive
- support for French, German, Italian, Japanese, Portuguese,
- Spanish, Catalan and Danish, and there are more than fifteen
- active translation teams. </p>
+
+ <p>Debian 3.0 is much more secure that previous releases. The base
+ installation provides fewer unnecessary services that might be the
+ target of attack. Debian 3.0 includes many more security-oriented
+ applications such as firewall administration, server hardening and
+ intrusion detection. The packaging system has also been improved
+ so it can be configured to automatically check digital signatures.
+ When configured, it will refuse to install Debian packages if the
+ digital signature doesn't match. This limits the possibility of
+ trojan horse installation and makes it easier and safer for
+ systems to automatically upgrade themselves over the Internet.
+ Lastly, Debian now provides intensive documentation for the
+ security-aware administrator including the <url
+ id="http://www.debian.org/doc/manuals/securing-debian-howto";
+ name="'Securing Debian Manual'"> from the Debian Documentation
+ Project (also available in the <package/harden-doc/ package).</p>
+
+ <p>Debian 3.0 is also much more <url
+ id="http://www.debian.org/international"; name="internationalized">
+ than previous releases thanks to the ongoing work of free software
+ translation teams. Debian includes default settings for more
+ languages than previous releases, and more of its programs are
+ international-ready. This includes the boot-floppies installation
+ which has been translated to a number of languages. There is
+ extensive support for French, German, Italian, Japanese,
+ Portuguese, Spanish, Catalan and Danish, and there are more than
+ fifteen active translation teams. </p>
<!-- TODO:
@@ -222,20 +222,18 @@
]]>
- <p>The Debian package management tools apt and dpkg have
- been improved considerably in this release. Now apt
- supports "pinning" in which the user can opt to
- download certain packages from different distributions,
- e.g. testing or unstable, while still keeping the bulk
- of packages in the stable distribution. APT
- will automagically download and install appropriate
- dependent packages from the advanced distribution as
- required. An apt "pinning" <url
+ <p>The Debian package management tools apt and dpkg have been
+ improved considerably in this release. Now apt supports "pinning"
+ in which the user can opt to download certain packages from
+ different distributions, e.g. testing or unstable, while still
+ keeping the bulk of packages in the stable distribution. APT will
+ automagically download and install appropriate dependent packages
+ from the advanced distribution as required. An apt "pinning" <url
id="http://www.debian.org/doc/manuals/apt-howto/ch-apt-get";
name="howto"> is available.</p>
- <p>Build dependencies have been added to aid the compilation
- of source packages. The "build-dep" apt-get method can be used to
+ <p>Build dependencies have been added to aid the compilation of
+ source packages. The "build-dep" apt-get method can be used to
retrieve all packages needed for a build before compilation is
commenced.</p>
Reply to: