Philipp Kern writes:
> On 2009-08-18, Andrea Bolognani wrote:
>> This also means localized manpages will always fail the simple date
>> check, unless you use the same .TH line in every localized
>> manpage. Doing so, however, would make it as impossible to know which
>> manpages are outdated bas
On Tue, Aug 18, 2009 at 08:13:20PM +1000, Ben Finney wrote:
> Roger Leigh writes:
>
> > I, for example, use the date format '+%d %b %Y' (01 Aug 2009). The
> > manual pages are human readable documentation. I think that nicely
> > readable dates should be preferred here.
>
> This seems to falsely
On Tue, Aug 18, 2009 at 12:21:38PM +0100, Alastair McKinstry wrote:
>>>
>>
>> It's only unambiguous if you know the convention being adopted /is/
>> ISO-8601. In an ideal world, we could have a standardised date format
>> which the man program can transform into the date representation of
>> the u
It's only unambiguous if you know the convention being adopted /is/
ISO-8601. In an ideal world, we could have a standardised date format
which the man program can transform into the date representation of
the user's locale thus satisfying all requirements.
???
Thats what ISO-8601 is. There
On Tue, 18 Aug 2009 10:29:32 + (UTC), Philipp Kern
wrote:
>
> And what should we do if a localized manpage is in fact
> the authoriative one?
That doesn't change a thing: if the date in the .TH line is
supposed to be that of the last update (making a lintian
check based on that date would ot
On Tue, Aug 18, 2009 at 08:13:20PM +1000, Ben Finney wrote:
> Roger Leigh writes:
>
> > On Mon, Aug 17, 2009 at 01:01:34PM +1000, Ben Finney wrote:
> > > I assume we expect man pages to conform to the conventions in
> > > ‘man-pages(7)’.
>
> (I've now been disabused of that assumption.)
>
> > I
On 2009-08-18, Andrea Bolognani wrote:
> This also means localized manpages will always fail the simple
> date check, unless you use the same .TH line in every localized
> manpage. Doing so, however, would make it as impossible to know
> which manpages are outdated based on the .TH line.
And what
Roger Leigh writes:
> On Mon, Aug 17, 2009 at 01:01:34PM +1000, Ben Finney wrote:
> > I assume we expect man pages to conform to the conventions in
> > ‘man-pages(7)’.
(I've now been disabused of that assumption.)
> I'm not sure we can have that expectation. If you look at
> groff_man(7), it sp
> This is just my own personal use of .TH in all my projects
> , using sbuild as an example:
>
> TH SCHROOT 1 "@RELEASE_DATE@" "Version @VERSION@" "Debian
> sbuild"
>
> where @RELEASE_DATE@ is the date of the release, which
> gets substituted in by autoconf's configure script
> (schroot.1.in -> s
On Mon, Aug 17, 2009 at 01:01:34PM +1000, Ben Finney wrote:
> gregor herrmann writes:
>
> > An interesting question is how to detect outdated translated manpages;
>
> According to ‘man-pages(7)’, the TH command in the man page should have
> the date of the latest version of the document:
>
>
Nicolas François writes:
> But I agree that if both the English and a translated manpages have a
> date in the format -MM-DD, and the date of the translated manpages
> has an older date, lintian could warn.
Well if we're dreaming up proposed tests (sans implementation) for
Lintian to perform
On Mon, Aug 17, 2009 at 07:10:00PM -0700, Russ Allbery wrote:
> Ben Finney writes:
>
> > What is the governing standard for Debian man pages, and what does it
> > say about the ‘TH’ command?
>
> I don't believe we have any standard other than "you should have one" and
> some guidelines about tra
On Mon, Aug 17, 2009 at 09:53:34AM -0700, Russ Allbery wrote:
> Yves-Alexis Perez writes:
> > On lun, 2009-08-17 at 13:01 +1000, Ben Finney wrote:
>
> >> So surely the best way to tell if a translated page is out of date is
> >> to compare these dates in the two documents, no?
>
> > And I guess
Ben Finney writes:
> The description in ‘man-pages(7)’ (quoted earlier in this thread) says
> “This page describes the conventions that should be employed when
> writing man pages for the Linux man-pages project”. Admittedly, that's a
> “should”, and Linux != Debian.
Also (which you probably kno
Russ Allbery writes:
> I suspect that this is going to not be as accurate as we might hope,
> but it is at least fairly easy to check and there's a simple fix for
> false positives (updating the .TH date), so it seems reasonable to me.
Right. It doesn't need to be perfect, so long as the detrime
Yves-Alexis Perez writes:
> On lun, 2009-08-17 at 13:01 +1000, Ben Finney wrote:
>> So surely the best way to tell if a translated page is out of date is
>> to compare these dates in the two documents, no?
> And I guess it should be easy to make a lintian test for that?
I suspect that this is g
On lun, 2009-08-17 at 13:01 +1000, Ben Finney wrote:
> So surely the best way to tell if a translated page is out of date is to
> compare these dates in the two documents, no?
And I guess it should be easy to make a lintian test for that?
Cheers,
--
Yves-Alexis
--
To UNSUBSCRIBE, email to deb
gregor herrmann writes:
> An interesting question is how to detect outdated translated manpages;
According to ‘man-pages(7)’, the TH command in the man page should have
the date of the latest version of the document:
The first command in a man page should be a TH command:
Christian Perrier writes:
> Before people "blindly" update their Standards-Version, I deeply
> suggest looking at this item:
>> * Localized man pages should either be kept up-to-date with the
>> original version or warn that they're not up-to-date, either with
>> warning text or by sho
On Sun, 16 Aug 2009 21:51:32 +0800
Paul Wise wrote:
> > I did start such a guide via my blog during DebConf8
> >
> > http://www.linux.codehelp.co.uk/serendipity/index.php?/archives/129-po4a-translation-support-from-any-format.html
>
> Would you (or anyone else) be willing to turn this into an ar
On Sun, 16 Aug 2009 15:22:26 +0200
gregor herrmann wrote:
> > > As such, this "should" prevents *many* packages to meet 3.8.3 for
> > > Standards-Version. You may thus want to check things carefully..:)
>
> An interesting question is how to detect outdated translated
> manpages; if they are only
Hello Gregor,
On Sun, Aug 16, 2009 at 03:22:26PM +0200, gregor herrmann wrote:
> On Sun, 16 Aug 2009 12:44:18 +0200, Helge Kreutzmann wrote:
> > > As such, this "should" prevents *many* packages to meet 3.8.3 for
> > > Standards-Version. You may thus want to check things carefully..:)
>
> An inter
On Sun, Aug 16, 2009 at 5:05 PM, Neil Williams wrote:
> po4a
>
> I did start such a guide via my blog during DebConf8
>
> http://www.linux.codehelp.co.uk/serendipity/index.php?/archives/129-po4a-translation-support-from-any-format.html
Would you (or anyone else) be willing to turn this into an a
On Sun, 16 Aug 2009 12:44:18 +0200, Helge Kreutzmann wrote:
> > > * Localized man pages should either be kept up-to-date with the
> > > original version or warn that they're not up-to-date, either with
> > > warning text or by showing missing or changed portions in the
> > > original
Hello,
On Sun, Aug 16, 2009 at 10:44:33AM +0200, Michal ??iha?? wrote:
> Dne Sun, 16 Aug 2009 16:31:09 +0800
> Paul Wise napsal(a):
>
> > Could the i18n team write something about the technical details of
> > doing translated manual pages the "right way" that could be shown to
> > upstreams and p
Hello Christian,
as the one originally suggesting this I guess I might add something.
On Sun, Aug 16, 2009 at 09:49:13AM +0200, Christian Perrier wrote:
> Before people "blindly" update their Standards-Version, I deeply
> suggest looking at this item:
>
> > * Localized man pages should either b
Hi
Dne Sun, 16 Aug 2009 16:31:09 +0800
Paul Wise napsal(a):
> Could the i18n team write something about the technical details of
> doing translated manual pages the "right way" that could be shown to
> upstreams and promoted via lwn.net, blogs and similar? I wanted to do
> translated manual page
On Sun, 16 Aug 2009 16:31:09 +0800
Paul Wise wrote:
> On Sun, Aug 16, 2009 at 3:49 PM, Christian Perrier wrote:
>
> > Before people "blindly" update their Standards-Version, I deeply
> > suggest looking at this item:
> >
> >> * Localized man pages should either be kept up-to-date with the
> >>
On Sun, Aug 16, 2009 at 3:49 PM, Christian Perrier wrote:
> Before people "blindly" update their Standards-Version, I deeply
> suggest looking at this item:
>
>> * Localized man pages should either be kept up-to-date with the
>> original version or warn that they're not up-to-date, either wi
Before people "blindly" update their Standards-Version, I deeply
suggest looking at this item:
> * Localized man pages should either be kept up-to-date with the
> original version or warn that they're not up-to-date, either with
> warning text or by showing missing or changed portions in
30 matches
Mail list logo
