util-linux.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
* Errors in util-linux man pages, here: logger.1: Missing markup
@ 2020-05-14 18:51 Helge Kreutzmann
  0 siblings, 0 replies; 4+ messages in thread
From: Helge Kreutzmann @ 2020-05-14 18:51 UTC (permalink / raw)
  To: util-linux; +Cc: mario.blaettermann

Dear util-linux maintainers.
the manpage-l10n project maintains a large number of translations of
man pages both from a large variety of sources (including util-linux) as
well for a large variety of target languages.

During their work translators notice different possible issues in the
original (english) man pages. Sometiems this is a straightforward
typo, sometimes a hard to read sentence, sometimes this is a
convention not held up and sometimes we simply do not understand the 
original.

We use several distributions as sources and update regularly (at
least every 2 month). This means we are fairly recent (some
distributions like archlinux also update frequently) but might miss
the latest upstream version once a while, so the error might be
already fixed. We apologize and ask you to close the issue immediately
if this should be the case, but given the huge volume of projects and
the very limited number of volunteers we are not able to double check
each and every issue.

Secondly we translators see the manpages in the neutral po format,
i.e. converted and harmonized, but not the original source (be it man,
groff, xml or other). So we cannot provide a true patch (where
possible), but only an approximation which you need to convert into
your source format.

Finally the issues I'm reporting have accumulated over time and are
not always discovered by me, so sometimes my description of the
problem my be a bit limited - do not hesitate to ask so we can clarify
them.

I'm now reporting the errors for your project. If future reports should 
use another channel, please let me know.

**

Man page: logger.1
Issue: Missing markup for command name

"The logger command is part of the util-linux package and is available from "
"E<.UR https://\\:www.kernel.org\\:/pub\\:/linux\\:/utils\\:/util-linux/> "
"Linux Kernel Archive E<.UE .>"

Greetings

           Helge

-- 
      Dr. Helge Kreutzmann                     debian@helgefjell.de
           Dipl.-Phys.                   http://www.helgefjell.de/debian.php
        64bit GNU powered                     gpg signed mail preferred
           Help keep free software "libre": http://www.ffii.de/

^ permalink raw reply	[flat|nested] 4+ messages in thread

* Errors in util-linux man pages, here: logger.1: Missing markup
@ 2020-05-14 18:52 Helge Kreutzmann
  0 siblings, 0 replies; 4+ messages in thread
From: Helge Kreutzmann @ 2020-05-14 18:52 UTC (permalink / raw)
  To: util-linux; +Cc: mario.blaettermann

Dear util-linux maintainers.
the manpage-l10n project maintains a large number of translations of
man pages both from a large variety of sources (including util-linux) as
well for a large variety of target languages.

During their work translators notice different possible issues in the
original (english) man pages. Sometiems this is a straightforward
typo, sometimes a hard to read sentence, sometimes this is a
convention not held up and sometimes we simply do not understand the 
original.

We use several distributions as sources and update regularly (at
least every 2 month). This means we are fairly recent (some
distributions like archlinux also update frequently) but might miss
the latest upstream version once a while, so the error might be
already fixed. We apologize and ask you to close the issue immediately
if this should be the case, but given the huge volume of projects and
the very limited number of volunteers we are not able to double check
each and every issue.

Secondly we translators see the manpages in the neutral po format,
i.e. converted and harmonized, but not the original source (be it man,
groff, xml or other). So we cannot provide a true patch (where
possible), but only an approximation which you need to convert into
your source format.

Finally the issues I'm reporting have accumulated over time and are
not always discovered by me, so sometimes my description of the
problem my be a bit limited - do not hesitate to ask so we can clarify
them.

I'm now reporting the errors for your project. If future reports should 
use another channel, please let me know.

**

Man page: logger.1
Issue: or the journal → to the journal?

"Causes everything to be done except for writing the log message to the "
"system log, and removing the connection or the journal.  This option can be "
"used together with B<--stderr> for testing purposes."

Greetings

           Helge

-- 
      Dr. Helge Kreutzmann                     debian@helgefjell.de
           Dipl.-Phys.                   http://www.helgefjell.de/debian.php
        64bit GNU powered                     gpg signed mail preferred
           Help keep free software "libre": http://www.ffii.de/

^ permalink raw reply	[flat|nested] 4+ messages in thread

* Errors in util-linux man pages, here: logger.1: Missing markup
@ 2020-05-14 18:51 Helge Kreutzmann
  0 siblings, 0 replies; 4+ messages in thread
From: Helge Kreutzmann @ 2020-05-14 18:51 UTC (permalink / raw)
  To: util-linux; +Cc: mario.blaettermann

Dear util-linux maintainers.
the manpage-l10n project maintains a large number of translations of
man pages both from a large variety of sources (including util-linux) as
well for a large variety of target languages.

During their work translators notice different possible issues in the
original (english) man pages. Sometiems this is a straightforward
typo, sometimes a hard to read sentence, sometimes this is a
convention not held up and sometimes we simply do not understand the 
original.

We use several distributions as sources and update regularly (at
least every 2 month). This means we are fairly recent (some
distributions like archlinux also update frequently) but might miss
the latest upstream version once a while, so the error might be
already fixed. We apologize and ask you to close the issue immediately
if this should be the case, but given the huge volume of projects and
the very limited number of volunteers we are not able to double check
each and every issue.

Secondly we translators see the manpages in the neutral po format,
i.e. converted and harmonized, but not the original source (be it man,
groff, xml or other). So we cannot provide a true patch (where
possible), but only an approximation which you need to convert into
your source format.

Finally the issues I'm reporting have accumulated over time and are
not always discovered by me, so sometimes my description of the
problem my be a bit limited - do not hesitate to ask so we can clarify
them.

I'm now reporting the errors for your project. If future reports should 
use another channel, please let me know.

**

Man page: logger.1
Issue: Missing markup of parameters

"B<logger> currently generates the B<timeQuality> standardized element only.  "
"RFC 5424 also describes the elements B<origin> (with parameters ip, "
"enterpriseId, software and swVersion) and B<meta> (with parameters "
"sequenceId, sysUpTime and language).  These element IDs may be specified "
"without the B<@>I<digits> suffix."

Greetings

           Helge

-- 
      Dr. Helge Kreutzmann                     debian@helgefjell.de
           Dipl.-Phys.                   http://www.helgefjell.de/debian.php
        64bit GNU powered                     gpg signed mail preferred
           Help keep free software "libre": http://www.ffii.de/

^ permalink raw reply	[flat|nested] 4+ messages in thread

* Errors in util-linux man pages, here: logger.1: Missing markup
@ 2020-05-14 18:51 Helge Kreutzmann
  0 siblings, 0 replies; 4+ messages in thread
From: Helge Kreutzmann @ 2020-05-14 18:51 UTC (permalink / raw)
  To: util-linux; +Cc: mario.blaettermann

Dear util-linux maintainers.
the manpage-l10n project maintains a large number of translations of
man pages both from a large variety of sources (including util-linux) as
well for a large variety of target languages.

During their work translators notice different possible issues in the
original (english) man pages. Sometiems this is a straightforward
typo, sometimes a hard to read sentence, sometimes this is a
convention not held up and sometimes we simply do not understand the 
original.

We use several distributions as sources and update regularly (at
least every 2 month). This means we are fairly recent (some
distributions like archlinux also update frequently) but might miss
the latest upstream version once a while, so the error might be
already fixed. We apologize and ask you to close the issue immediately
if this should be the case, but given the huge volume of projects and
the very limited number of volunteers we are not able to double check
each and every issue.

Secondly we translators see the manpages in the neutral po format,
i.e. converted and harmonized, but not the original source (be it man,
groff, xml or other). So we cannot provide a true patch (where
possible), but only an approximation which you need to convert into
your source format.

Finally the issues I'm reporting have accumulated over time and are
not always discovered by me, so sometimes my description of the
problem my be a bit limited - do not hesitate to ask so we can clarify
them.

I'm now reporting the errors for your project. If future reports should 
use another channel, please let me know.

**

Man page: logger.1
Issue: Missing markup of command name

"Log the PID of the logger process with each line.  When the optional "
"argument I<id> is specified, then it is used instead of the logger command's "
"PID.  The use of B<--id=$$> (PPID) is recommended in scripts that send "
"several messages."

"Write a systemd journal entry.  The entry is read from the given I<file>, "
"when specified, otherwise from standard input.  Each line must begin with a "
"field that is accepted by journald; see B<systemd.journal-fields>(7)  for "
"details.  The use of a MESSAGE_ID field is generally a good idea, as it "
"makes finding entries easy.  Examples:"

"Use the specified I<port>.  When this option is not specified, the port "
"defaults to syslog for udp and to syslog-conn for tcp connections."

"Most receivers accept messages larger than 1KiB over any type of syslog "
"protocol.  As such, the B<--size> option affects logger in all cases (not "
"only when B<--rfc5424> was used)."

Greetings

           Helge

-- 
      Dr. Helge Kreutzmann                     debian@helgefjell.de
           Dipl.-Phys.                   http://www.helgefjell.de/debian.php
        64bit GNU powered                     gpg signed mail preferred
           Help keep free software "libre": http://www.ffii.de/

^ permalink raw reply	[flat|nested] 4+ messages in thread

end of thread, other threads:[~2020-05-14 18:52 UTC | newest]

Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-05-14 18:51 Errors in util-linux man pages, here: logger.1: Missing markup Helge Kreutzmann
  -- strict thread matches above, loose matches on Subject: below --
2020-05-14 18:52 Helge Kreutzmann
2020-05-14 18:51 Helge Kreutzmann
2020-05-14 18:51 Helge Kreutzmann

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).