linux-man.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
From: Helge Kreutzmann <debian@helgefjell.de>
To: "Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com>
Cc: Jakub Wilk <jwilk@jwilk.net>, linux-man <linux-man@vger.kernel.org>
Subject: Re: Errors in man pages, here: signal(7): Sentence to long
Date: Fri, 24 Apr 2020 20:50:36 +0200	[thread overview]
Message-ID: <20200424185036.GC7401@Debian-50-lenny-64-minimal> (raw)
In-Reply-To: <CAKgNAkj6j2Y1YphseM54y_2=xQV3E4Rc+UX4TPC4VgtX4D0V9w@mail.gmail.com>

[-- Attachment #1: Type: text/plain, Size: 2781 bytes --]

Hello Michael,
On Mon, Apr 20, 2020 at 10:51:00AM +0200, Michael Kerrisk (man-pages) wrote:
> On Mon, 20 Apr 2020 at 10:49, Jakub Wilk <jwilk@jwilk.net> wrote:
> >
> > * Michael Kerrisk (man-pages) <mtk.manpages@gmail.com>, 2020-04-20, 10:33:
> > >>"A signal may be generated (and thus pending)  for a process as a whole (e."
> > >>"g., when sent using B<kill>(2))  or for a specific thread (e.g., certain "
> > >>"signals, such as B<SIGSEGV> and B<SIGFPE>, generated as a consequence of "
> > >>"executing a specific machine-language instruction are thread directed, as "
> > >>"are signals targeted at a specific thread using B<pthread_kill>(3)).  A "
> > >>"process-directed signal may be delivered to any one of the threads that does "
> > >>"not currently have the signal blocked.  If more than one of the threads has "
> > >>"the signal unblocked, then the kernel chooses an arbitrary thread to which "
> > >>"to deliver the signal."
> > >
> > >I can't find the text referred to. I think you may be working
> > >with an older version of the page. Can you please check.
> >
> > In 3b9d44099f234e8e, the long sentence was replaced with this paragraph:
> >
> > "A signal may be process-directed or thread-directed. A process-directed
> > signal is one that is targeted at (and thus pending for) the process as
> > a whole. A signal may be process-directed because it was generated by
> > the kernel for reasons other than a hardware exception, or because it
> > was sent using kill(2) or sigqueue(3). A thread-directed signals is one
> > that is targeted at a specific thread. A signal may be thread-directed
> > because it was generated as a consequence of executing a specific
> > machine-language instruction that triggered a hardware exception (e.g.,
> > SIGSEGV for an invalid memory access, or SIGFPE for a math error), or
> > because it was it was targeted at a specific thread using interfaces
> > such as tgkill(2) or pthread_kill(3).
> 
> Thanks, Jakub.

Thanks. 

We are working with what our upstreams provide, and especially
archlinux tries to update frequently (but we might lag a few weeks
behind them), so from time to time the issue might already been fixed.
Due to the sheer size of upstreams and man pages and potential issues
to be fixed we unfortunately might occasionally thus report issues
already dealt with by you (or your fellow maintainers of other
projects).

Sorry for the noise.

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/

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

      reply	other threads:[~2020-04-24 18:50 UTC|newest]

Thread overview: 5+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2020-04-19  6:48 Errors in man pages, here: signal(7): Sentence to long Helge Kreutzmann
2020-04-20  8:33 ` Michael Kerrisk (man-pages)
2020-04-20  8:49   ` Jakub Wilk
2020-04-20  8:51     ` Michael Kerrisk (man-pages)
2020-04-24 18:50       ` Helge Kreutzmann [this message]

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20200424185036.GC7401@Debian-50-lenny-64-minimal \
    --to=debian@helgefjell.de \
    --cc=jwilk@jwilk.net \
    --cc=linux-man@vger.kernel.org \
    --cc=mtk.manpages@gmail.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
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).