[v2,00/13] Replace us of term abort

  The term 'abort' is on the inclusive namin Tier 1 word list
as replace when possible. It is possible to do this across
DPDK except the few places that directly call the lib C abort()
function.

v2 - drop changes to sfc since requires changes to base driver
   - cleanup some checkpatch and missing spots

Rationale (from https://inclusivenaming.org/word-lists/tier-1/abort/)

    The term “abort” frequently appeared in Inclusive Language
    Initiative surveys and standards reviews. Multiple organizations felt
    that usage of the word posed an issue worth addressing in their
    individual companies and projects. Given this widespread interest, the
    INI has decided to offer its own guidance.

    INI recommends replacing “abort” wherever possible. In accordance with
    the INI’s language framework, the term does not necessarily constitute
    a first-order concern. However, because it is such a charged term
    outside of computing, “abort” fails to provide a clear description of
    the action being taken, and serves primarily to distract. There are
    numerous other words in the English language that can serve the same
    purpose in computing without invoking the emotionally charged cultural
    context of “abort.”

    Although the INI debated whether the word “abort” itself or the
    procedure commonly associated with it (“abortion”) caused the
    aforementioned distractions, the etymology of the word has a direct
    and unambiguous link to the termination of a pregnancy. Alternative
    uses of the word “abort” are in use today, such as in
    rocketry. However, the INI concluded that the term itself was
    insufficiently distanced from its original meaning for those
    alternative definitions to be its primary association.

    All this being said, the INI does not advocate for a blanket
    replacement of the term. “Abort” appears in many standards
    organization documents, and is deeply embedded in some operating
    systems. As such, the INI acknowledges that the term may need to
    be retained in certain contexts to remain in compliance with those
    standards, or to preserve accurate documentation for bedrock
    functions and processes that are too fundamental to be changed.

    Some organizations have noted that using “abort” in contexts other
    than the medical or political serves to de-stigmatize the term,
    thereby promoting reproductive rights and bodily autonomy. Conversely,
    discouraging the term could be interpreted as accepting a framing that
    denies a pregnant person’s right to control their body. The judgment
    of the INI is that the term causes discomfort or offense without
    providing a necessary degree of technical clarity, and therefore it
    should be avoided. At some future point, because language changes over
    time, “abort” may become a less contentious term; at that juncture,
    the appropriateness of the term may be revisited.


Stephen Hemminger (13):
  jobstats: change jobstats_abort to jobstats_cancel
  all: remove use of word abort
  pipeline: remove use of term abort
  net/vmxnet3: replace abort() with rte_panic()
  event/dlb2: remove word abort in comments
  net/vdev_netvsc: replace use of term abort
  net/netvsc: replace abort with cancel
  net/ionic: remove word aborting
  net/bnx2x: replace abort with cancel
  net/mlx5: replace abort with cancel
  net/softnic: replace abort with cancel
  net/mlx4: remove word abort
  net/axgbe: replace word abort

 .../comp_perf_test_cyclecount.c               |  2 +-
 .../comp_perf_test_throughput.c               |  2 +-
 .../comp_perf_test_verify.c                   |  2 +-
 app/test/test_dmadev.c                        |  2 +-
 doc/guides/prog_guide/bpf_lib.rst             |  2 +-
 doc/guides/prog_guide/traffic_management.rst  |  2 +-
 drivers/common/mlx5/mlx5_common_mr.c          |  6 ++--
 drivers/common/mlx5/mlx5_prm.h                |  4 +--
 drivers/dma/hisilicon/hisi_dmadev.c           |  4 +--
 drivers/dma/hisilicon/hisi_dmadev.h           |  2 +-
 drivers/event/dlb2/dlb2.c                     |  2 +-
 drivers/event/dlb2/pf/base/dlb2_resource.c    |  2 +-
 drivers/net/af_xdp/rte_eth_af_xdp.c           |  2 +-
 drivers/net/axgbe/axgbe_common.h              |  4 +--
 drivers/net/axgbe/axgbe_ethdev.h              |  2 +-
 drivers/net/axgbe/axgbe_i2c.c                 | 26 ++++++++---------
 drivers/net/bnx2x/bnx2x.c                     | 18 ++++++------
 drivers/net/bnx2x/bnx2x_vfpf.c                |  4 +--
 drivers/net/bnx2x/ecore_hsi.h                 |  6 ++--
 drivers/net/bnx2x/ecore_reg.h                 | 20 ++++++-------
 drivers/net/ionic/ionic_dev_pci.c             |  6 ++--
 drivers/net/ionic/ionic_ethdev.c              | 18 ++++++------
 drivers/net/ionic/ionic_lif.c                 |  2 +-
 drivers/net/mlx4/mlx4_mr.c                    |  6 ++--
 drivers/net/mlx5/hws/mlx5dr_rule.c            |  8 ++---
 drivers/net/mlx5/hws/mlx5dr_send.c            |  2 +-
 drivers/net/mlx5/hws/mlx5dr_send.h            |  2 +-
 drivers/net/mlx5/linux/mlx5_os.c              |  4 +--
 drivers/net/mlx5/mlx5_rx.c                    |  2 +-
 drivers/net/netvsc/rndis.h                    |  2 +-
 drivers/net/softnic/rte_eth_softnic_cli.c     | 12 ++++----
 drivers/net/vdev_netvsc/vdev_netvsc.c         |  4 +--
 drivers/net/vmxnet3/vmxnet3_rxtx.c            |  6 ++--
 examples/ipsec-secgw/rt.c                     |  4 +--
 examples/l2fwd-jobstats/main.c                |  2 +-
 examples/pipeline/cli.c                       | 20 ++++++-------
 lib/dmadev/rte_dmadev.h                       |  6 ++--
 .../include/generic/rte_power_intrinsics.h    | 10 +++----
 lib/eal/include/generic/rte_rwlock.h          |  4 +--
 lib/eal/include/generic/rte_spinlock.h        |  8 ++---
 lib/eal/include/rte_seqlock.h                 |  2 +-
 lib/eal/x86/include/rte_rtm.h                 | 16 +++++-----
 lib/eal/x86/include/rte_spinlock.h            | 12 ++++----
 lib/eal/x86/rte_power_intrinsics.c            |  8 ++---
 lib/ethdev/rte_tm.h                           |  2 +-
 lib/hash/rte_cuckoo_hash.h                    |  2 +-
 lib/jobstats/rte_jobstats.c                   |  2 +-
 lib/jobstats/rte_jobstats.h                   |  9 +++++-
 lib/jobstats/version.map                      |  2 +-
 lib/pipeline/rte_swx_ctl.c                    | 29 ++++++++++---------
 lib/pipeline/rte_swx_ctl.h                    |  8 ++---
 lib/pipeline/version.map                      |  2 +-
 lib/ring/rte_ring_peek_elem_pvt.h             |  4 +--
 53 files changed, 174 insertions(+), 166 deletions(-)
  

18/08/2023 19:45, Stephen Hemminger:
> The term 'abort' is on the inclusive namin Tier 1 word list
> as replace when possible. It is possible to do this across
> DPDK except the few places that directly call the lib C abort()
> function.
> 
> v2 - drop changes to sfc since requires changes to base driver
>    - cleanup some checkpatch and missing spots
> 
> Rationale (from https://inclusivenaming.org/word-lists/tier-1/abort/)
> 
>     The term “abort” frequently appeared in Inclusive Language
>     Initiative surveys and standards reviews. Multiple organizations felt
>     that usage of the word posed an issue worth addressing in their
>     individual companies and projects. Given this widespread interest, the
>     INI has decided to offer its own guidance.
> 
>     INI recommends replacing “abort” wherever possible. In accordance with
>     the INI’s language framework, the term does not necessarily constitute
>     a first-order concern. However, because it is such a charged term
>     outside of computing, “abort” fails to provide a clear description of
>     the action being taken, and serves primarily to distract. There are
>     numerous other words in the English language that can serve the same
>     purpose in computing without invoking the emotionally charged cultural
>     context of “abort.”
> 
>     Although the INI debated whether the word “abort” itself or the
>     procedure commonly associated with it (“abortion”) caused the
>     aforementioned distractions, the etymology of the word has a direct
>     and unambiguous link to the termination of a pregnancy. Alternative
>     uses of the word “abort” are in use today, such as in
>     rocketry. However, the INI concluded that the term itself was
>     insufficiently distanced from its original meaning for those
>     alternative definitions to be its primary association.
> 
>     All this being said, the INI does not advocate for a blanket
>     replacement of the term. “Abort” appears in many standards
>     organization documents, and is deeply embedded in some operating
>     systems. As such, the INI acknowledges that the term may need to
>     be retained in certain contexts to remain in compliance with those
>     standards, or to preserve accurate documentation for bedrock
>     functions and processes that are too fundamental to be changed.
> 
>     Some organizations have noted that using “abort” in contexts other
>     than the medical or political serves to de-stigmatize the term,
>     thereby promoting reproductive rights and bodily autonomy. Conversely,
>     discouraging the term could be interpreted as accepting a framing that
>     denies a pregnant person’s right to control their body. The judgment
>     of the INI is that the term causes discomfort or offense without
>     providing a necessary degree of technical clarity, and therefore it
>     should be avoided. At some future point, because language changes over
>     time, “abort” may become a less contentious term; at that juncture,
>     the appropriateness of the term may be revisited.

I don't feel the rationale should be followed here.
If there are better terms, why not.
But really, "abort" is not only medical.
And banning this word may be felt as a political position,
which is not what we want.

I am OK to replace if there is a better word in some contexts,
but we should not make it forbidden.
  

On Wed, 30 Aug 2023 18:49:14 +0200
Thomas Monjalon <thomas@monjalon.net> wrote:

> I don't feel the rationale should be followed here.
> If there are better terms, why not.
> But really, "abort" is not only medical.
> And banning this word may be felt as a political position,
> which is not what we want.
> 
> I am OK to replace if there is a better word in some contexts,
> but we should not make it forbidden.

There are two overlapping reasons behind this.
First, any reference to abortion in the US is a political hot button.
Therefore the recommendation is to avoid the term.

The other reason is that the term may raise some negative feelings
from people that have had to have an abortion.

According to the etymology sites and dictionary sites
I looked at the term comes from a strictly medical point of view:
 https://www.etymonline.com/word/abortion
 https://www.merriam-webster.com/dictionary/abort
It looks like the secondary meaning in computer science came later.
It would be best if the term could be avoid if possible.
  

06/09/2023 21:39, Stephen Hemminger:
> On Wed, 30 Aug 2023 18:49:14 +0200
> Thomas Monjalon <thomas@monjalon.net> wrote:
> 
> > I don't feel the rationale should be followed here.
> > If there are better terms, why not.
> > But really, "abort" is not only medical.
> > And banning this word may be felt as a political position,
> > which is not what we want.
> > 
> > I am OK to replace if there is a better word in some contexts,
> > but we should not make it forbidden.
> 
> There are two overlapping reasons behind this.
> First, any reference to abortion in the US is a political hot button.

Sorry that you live in such a country ;)

> Therefore the recommendation is to avoid the term.
> 
> The other reason is that the term may raise some negative feelings
> from people that have had to have an abortion.

Forbidding the word may be understood as the opposite reason.
That's why I think we should not forbid the word officially.

> According to the etymology sites and dictionary sites
> I looked at the term comes from a strictly medical point of view:
>  https://www.etymonline.com/word/abortion
>  https://www.merriam-webster.com/dictionary/abort
> It looks like the secondary meaning in computer science came later.
> It would be best if the term could be avoid if possible.

If there are better alternatives, let's use them for the only reason
they are better understood in their respective context.
  

On Wed, 06 Sep 2023 23:19:23 +0200
Thomas Monjalon <thomas@monjalon.net> wrote:

> 06/09/2023 21:39, Stephen Hemminger:
> > On Wed, 30 Aug 2023 18:49:14 +0200
> > Thomas Monjalon <thomas@monjalon.net> wrote:
> >   
> > > I don't feel the rationale should be followed here.
> > > If there are better terms, why not.
> > > But really, "abort" is not only medical.
> > > And banning this word may be felt as a political position,
> > > which is not what we want.
> > > 
> > > I am OK to replace if there is a better word in some contexts,
> > > but we should not make it forbidden.  
> > 
> > There are two overlapping reasons behind this.
> > First, any reference to abortion in the US is a political hot button.  
> 
> Sorry that you live in such a country ;)
> 
> > Therefore the recommendation is to avoid the term.
> > 
> > The other reason is that the term may raise some negative feelings
> > from people that have had to have an abortion.  
> 
> Forbidding the word may be understood as the opposite reason.
> That's why I think we should not forbid the word officially.

With word choices, it is important to get an answer from the person most
likely to be impacted. I.e what would a politically active female in US
have to say.  Let me ask around to see if it matters.