Re: [Libreoffice] Patch to help text to document use of [] in time formats

On 06/07/2011 10:58:52 AM, Andras Timar wrote:
> id attributes are required for localization. id can be anything, but
> has to be unique within a file. Can you please add the id's? Also

Here's another version of the same patch this time with id
attributes.  

Did you leave off a part of your message after the "Also"?

Karl <kop@meme.com>
Free Software:  "You don't pay back, you pay forward."
                 -- Robert A. Heinlein

From 5697bbe1012e1519a2d09e91742307dda091c3b4 Mon Sep 17 00:00:00 2001
From: Karl O. Pinc <kop@meme.com>
Date: Tue, 7 Jun 2011 11:37:57 -0500
Subject: [PATCH] Second try at patch for bug #36057
  "Docs don't mention that time format using [] is needed to show hours non-modulo 24"

Add new paragraph and example table to the help text having to do with time
formatting explaining the use of [].

Note that this patch is very likely wrong.  I wasn't able to figure
out how to edit the help text using LibreOffice/OOO.  The table is
slightly odd in that it has 2 lines of headings, the first of which
spans the entire table, and it has an entirely empty column so as to,
in effect, have two tables side by side in order to compare what
happens with and without the use of square braces.

This version has unique id attribute values (within the file) for each
new paragraph and table element (even the empty paragraphs).
---
 helpcontent2/source/text/shared/01/05020301.xhp |   78 +++++++++++++++++++++++
 1 files changed, 78 insertions(+), 0 deletions(-)

diff --git a/helpcontent2/source/text/shared/01/05020301.xhp 
b/helpcontent2/source/text/shared/01/05020301.xhp
index d89091a..4f350d4 100644
--- a/helpcontent2/source/text/shared/01/05020301.xhp
+++ b/helpcontent2/source/text/shared/01/05020301.xhp
@@ -902,6 +902,84 @@
 </tablerow>
 </table>
 
+<paragraph role="paragraph" id="par_id3757982" xlm-lang="en-US" l10n="U">The display of the hour, 
minute, and second components of the time is capped at the maximal number of hours in a day (or 12 
hour period), minutes in an hour, or seconds in a minute.  To suppress this behavior use square 
brackets, [], as illustrated in the following table.</paragarph>
+<table id="tbl_id3154831">
+<tablerow>
+<table cell>
+<paragraph role="tablehead" id="par_id3157980" xml-lang="en-US" l10n="U">Display of the value 1 
day, 1 hour, 25 minutes, 9 seconds</paragraph>
+</tablecell>
+</tablerow>
+<tablerow>
+<tablecell>
+<paragraph role="tablehead" id="par_id3757983" xml-lang="en-US" l10n="U">Format Code</paragraph>
+</tablecell>
+<tablecell>
+<paragraph role="tablehead" id="par_id3757984" xml-lang="en-US" l10n="U">Output 
Displayed</paragraph>
+</tablecell>
+<tablecell>
+<paragraph role="tablehead" id="par_id3757985" xml-lang="en-US" l10n="U"></paragraph>
+</tablecell>
+<tablecell>
+<paragraph role="tablehead" id="par_id3757986" xml-lang="en-US" l10n="U">Format Code</paragraph>
+</tablecell>
+<tablecell>
+<paragraph role="tablehead" id="par_id3757987" xml-lang="en-US" l10n="U">Output 
Displayed</paragraph>
+</tablecell>
+<tablecell>
+</tablerow>
+<tablerow>
+<tablecell>
+<paragraph role="code" id="par_id3757988" xml-lang="en-US" l10n="U">HH:MM:09</paragraph>
+</tablecell>
+<tablecell>
+<paragraph role="tablecontent" id="par_id3757989" xml-lang="en-US" l10n="U">01:25:09</paragraph>
+</tablecell>
+<tablecell>
+<paragraph role="tablecontent" id="par_id3757990" xml-lang="en-US" l10n="U"></paragraph>
+</tablecell>
+<tablecell>
+<paragraph role="code" id="par_id3757991" xml-lang="en-US" l10n="U">[HH]:MM</paragraph>
+</tablecell>
+<tablecell>
+<paragraph role="tablecontent" id="par_id3757992" xml-lang="en-US" l10n="U">25:25:09</paragraph>
+</tablecell>
+</tablerow>
+<tablerow>
+<tablecell>
+<paragraph role="code" id="par_id3757993" xml-lang="en-US" l10n="U">MM:SS</paragraph>
+</tablecell>
+<tablecell>
+<paragraph role="tablecontent" id="par_id3757994" xml-lang="en-US" l10n="U">25:09</paragraph>
+</tablecell>
+<tablecell>
+<paragraph role="tablecontent" id="par_id3757995" xml-lang="en-US" l10n="U"></paragraph>
+</tablecell>
+<tablecell>
+<paragraph role="code" id="par_id3757996" xml-lang="en-US" l10n="U">[MM]:SS</paragraph>
+</tablecell>
+<tablecell>
+<paragraph role="tablecontent" id="par_id3757997" xml-lang="en-US" l10n="U">1525:09</paragraph>
+</tablecell>
+</tablerow>
+<tablerow>
+<tablecell>
+<paragraph role="code" id="par_id3757998" xml-lang="en-US" l10n="U">SS</paragraph>
+</tablecell>
+<tablecell>
+<paragraph role="tablecontent" id="par_id3757999" xml-lang="en-US" l10n="U">09</paragraph>
+</tablecell>
+<tablecell>
+<paragraph role="tablecontent" id="par_id3758000" xml-lang="en-US" l10n="U"></paragraph>
+</tablecell>
+<tablecell>
+<paragraph role="code" id="par_id3758001" xml-lang="en-US" l10n="U">[SS]</paragraph>
+</tablecell>
+<tablecell>
+<paragraph role="tablecontent" id=par_id3758002" xml-lang="en-US" l10n="U">91509</paragraph>
+</tablecell>
+</tablerow>
+</table>
+
 <paragraph role="note" id="par_id3156039" xml-lang="en-US" l10n="U" oldref="77">To display seconds 
as fractions, add the decimal delimiter to your number format code. For example, enter 
<emph>hh:mm:ss.00</emph> to display the time as "01:02:03.45".<comment>Translators: use the decimal 
delimiter of your language (period or comma) for all number format codes in 
Calc.</comment></paragraph>
 <paragraph role="paragraph" id="par_id3148649" xml-lang="en-US" l10n="U" oldref="102">If a time is 
entered in the form 02:03.45 or 01:02:03.45 or 25:01:02, the following formats are assigned if no 
other time format has been specified: MM:SS.00 or [HH]:MM:SS.00 or [HH]:MM:SS<comment>Translators: 
use the decimal delimiter of your language (period or comma) for all number format codes in 
Calc.</comment></paragraph>
 <paragraph role="heading" id="hd_id3158404" xml-lang="en-US" level="2" l10n="U" 
oldref="169">Displaying Numbers Using Native Characters</paragraph>
-- 
1.7.2.5