Learn how easy it is to sync an existing GitHub or Google Code repo to a SourceForge project! See Demo

Close

#28 <caution> and <warning> output differences

open
nobody
None
5
2014-08-26
2006-01-14
siebrand
No

Background: I am a translator in the FreeBSD Dutch
Documentation Project. Our goal is to translate the
FreeBSD documentation to Dutch. As such I am editing
Docbook SGML files and have to deal with the
occasional oddities.

Source examples:
Original:
http://www.freebsd.org/cgi/cvsweb.cgi/doc/en_US.ISO885
9-1/books/handbook/security/chapter.sgml?rev=1.284
Translated:
http://www.freebsd.org/cgi/cvsweb.cgi/doc/nl_NL.ISO885
9-1/books/handbook/security/chapter.sgml?rev=1.13

Example output:
Original:
http://www.freebsd.org/doc/en/books/handbook/tcpwrappe
rs.html
Translated:
http://www.freebsd.org/doc/nl/books/handbook/tcpwrappe
rs.html

The strange thing is that when <caution> or <warning>
is used in English, the output looks like "Caution: "
and "Warning: ", but in almost all other languages it
looks like (in the localised version) "Caution"
and "Warning". One of the only languages that does
have the same markup as English is German. I have
found this to be related to the following types of
lines in dbl1XX.dsl:
dbl1de.dsl: (list
(normalize "caution") ": ")
dbl1nl.dsl: (list
(normalize "caution") "")

I have not been able to find the reasoning behind
this and maybe it's even something totally
overlooked. Applying the following patch fixes the
output for The Dutch FreeBSD Handbook for me, but I
have no idea if there will be any additional impact
elsewhere.

---- START DIFF ----
> diff -u ~/dbl1nl.dsl.orig ./dbl1nl.dsl
--- /home/siebrand/dbl1nl.dsl.orig Sat Jan 14
11:55:22 2006
+++ ./dbl1nl.dsl Sat Jan 14 11:56:44 2006
@@ -282,7 +282,7 @@
(list (normalize "abstract") ": ")
(list (normalize "answer") " ")
(list (normalize "appendix") ". ")
- (list (normalize "caution") "")
+ (list (normalize "caution") ": ")
(list (normalize "chapter") ". ")
(list (normalize "equation") ". ")
(list (normalize "example") ". ")
@@ -314,7 +314,7 @@
(list (normalize "step") ". ")
(list (normalize "table") ". ")
(list (normalize "tip") ": ")
- (list (normalize "warning") "")
+ (list (normalize "warning") ": ")
))

(define (gentext-nl-label-title-sep gind)
---- END DIFF ----

Discussion

  • Logged In: YES
    user_id=118135

     
    • assigned_to: nobody --> petere78
     
  • Logged In: YES
    user_id=118135

     
    • labels: 321158 -->
    • milestone: 447634 -->
    • assigned_to: petere78 --> nobody