[MPlayer-DOCS] Italian documentation

[Torinthiel]

On Fri, Feb 20, 2004 at 11:25:35AM +0100, Nicola Lacquaniti wrote:
[...]
> but doing so we can't know the english document from which we have started!
> Perhaps could be better do something as
> .\" $Revision: 1.545 $  // the original english document
> .\" Traduzione italiana rev. 1.0 // our revision
> 
> or
> 
> .\" $Revision: 1.0 $
> .\" Dalle pagine man inglesi rev. 1.545
> 
> we have to take into account that, even when we are talking, the english man pages are upgrated
> by the developers, so we have to keep trace of our and original revisions.

If you could stick to a rule that first line of manpage is
.\" synced with 1.xxx

and second line of each xml file is
<!-- synced with 1.xxx -->

It would comply with what is a custom now in documentation, and would be
easier to automatically track unsynced files.

> > I don't know anything about the messages *(i use then english
> > version) but in

Look at main/help. If you know C at least a bit than it's easy -
messages are just definitions in header files.

> > BTW it may be nice to have, at the beginning of the man page, a list of word
> > that we think is better not translate ( stream, streaming , demux and codec
> > are the first that come to mind) and a little explanation of what they mean.
> 
> I agree, but I think that this could be a conformity problem with the
> man pages translated in the other languages:
> perhaps other people in this list (with a better knowledge of the
> documentation system - Diego?) can suggest us the right way to do
> that...

I'm not Diego, but I suggest you should agree on it between yourselves.
It's language dependent and there is no place it should go in. And IMHO
it should not be visible to end users.
Torinthiel

-- 
 Waclaw "Torinthiel" Schiller       GG#: 542916, 3073512
   torinthiel(at)wp(dot)pl
   gpg: B06901F1 fpr: FAA3 559F CAE9 34DE CDC8  7346 2B6E 39F2 B069 01F1
 "No classmates may be used during this examination"
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
URL: <http://lists.mplayerhq.hu/pipermail/mplayer-docs/attachments/20040220/f814cffd/attachment.pgp>