From patchwork Fri Oct 30 17:10:39 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Carlos O'Donell X-Patchwork-Id: 40934 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 5F31E385141D; Fri, 30 Oct 2020 17:10:50 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 5F31E385141D DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1604077850; bh=K/JLEPuQ87IWXTIqshu0IngrsgGq9cvNysdRm/KZkmI=; h=To:Subject:Date:List-Id:List-Unsubscribe:List-Archive:List-Post: List-Help:List-Subscribe:From:Reply-To:Cc:From; b=B2zfDPZzxazVMRqFWdQkGuP96yRyET5xrKLebV4/p4TdHlx5ptiRXSrCoVG3EAP9q tmQE8EbiyvBZH88diQ79pttfFlCDVyWIX9WpLb+mob6fSWa1/aI75QcZ9A6HsArYaz hGejZN3Dnjo1sg9oOJpki4zbdmekUOFL6fYiJRVE= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [63.128.21.124]) by sourceware.org (Postfix) with ESMTP id 4227A3857C7B for ; Fri, 30 Oct 2020 17:10:48 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 4227A3857C7B Received: from mail-qk1-f199.google.com (mail-qk1-f199.google.com [209.85.222.199]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-46--yPnUDjoP3q6KpDpvLUUAA-1; Fri, 30 Oct 2020 13:10:46 -0400 X-MC-Unique: -yPnUDjoP3q6KpDpvLUUAA-1 Received: by mail-qk1-f199.google.com with SMTP id i2so4328897qkk.0 for ; Fri, 30 Oct 2020 10:10:46 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=K/JLEPuQ87IWXTIqshu0IngrsgGq9cvNysdRm/KZkmI=; b=dJBMmi+Yyjr1nd1dwSwrYeBZ04t5WMtCeHjqdOgUtK0PV7MQRBY1R1uUExqtJT2+Cf sNHn30d9hJVKUVva+twP6CTL7gf26u/bHInYZSQ3ubBYIUHuWZxX8pAAqaFqw6r6GzCC H3k7cZI15u1dse6J5CpZx+I+TTFuoEsqo2M/K9oggBG3yQ41pTnnn9Yy18rzAhhSnDez 4nyK4970zC25uqp3CbMULxF12HCh2AtRNNyLLcabCa3uhUtDr0de+WfSzme9OKAO7SbW UCkALzgjR4krmp+o3XH4EZbBZXSvYM3KVd6bJHwUjpubJJDl47oAqplyjR8Booa/O0m9 IjHA== X-Gm-Message-State: AOAM531+u3k/eB/fMfAB+BbAzWtOdUg2+o8kKF51iKX9j+jv8opJmQgY d8qKZ8GHuibnFq0N/DesUHcIQn3NbzZpMLdbK7VCgj7oSExtlVY/Qaeh4h58wUF28EPSO7wTGhG EFwpnMfnrJ9jUFMVwz2c2 X-Received: by 2002:a37:4e42:: with SMTP id c63mr2486371qkb.293.1604077845392; Fri, 30 Oct 2020 10:10:45 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwmqDJ1GwsmlX1J5RtcEXe0BLpygtRAcxZ//JnOyU2gRVpOejEsI8mYQriZRH5hSJsRoPtrEg== X-Received: by 2002:a37:4e42:: with SMTP id c63mr2486353qkb.293.1604077845187; Fri, 30 Oct 2020 10:10:45 -0700 (PDT) Received: from athas.redhat.com (198-84-214-74.cpe.teksavvy.com. [198.84.214.74]) by smtp.gmail.com with ESMTPSA id m27sm3133671qtm.72.2020.10.30.10.10.43 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 30 Oct 2020 10:10:44 -0700 (PDT) To: libc-alpha@sourceware.org Subject: [COMMITTED] Argument Syntax: Use "option", @option, and @command. Date: Fri, 30 Oct 2020 13:10:39 -0400 Message-Id: <20201030171039.3554340-1-carlos@redhat.com> X-Mailer: git-send-email 2.26.2 MIME-Version: 1.0 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com X-Spam-Status: No, score=-11.6 required=5.0 tests=BAYES_00, DKIMWL_WL_HIGH, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, GIT_PATCH_0, RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H5, RCVD_IN_MSPIKE_WL, SPF_HELO_NONE, SPF_PASS, TXREP autolearn=ham autolearn_force=no version=3.4.2 X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on server2.sourceware.org X-BeenThere: libc-alpha@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Libc-alpha mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: Carlos O'Donell via Libc-alpha From: Carlos O'Donell Reply-To: Carlos O'Donell Cc: David O'Brien Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Suggested-by: David O'Brien --- manual/startup.texi | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/manual/startup.texi b/manual/startup.texi index 21c48cd037..9bf24123f5 100644 --- a/manual/startup.texi +++ b/manual/startup.texi @@ -125,13 +125,13 @@ Option names are single alphanumeric characters (as for @code{isalnum}; @pxref{Classification of Characters}). @item -Certain options require an argument. For example, the @samp{-o} command -of the @code{ld} command requires an argument---an output file name. +Certain options require an argument. For example, the @option{-o} option +of the @command{ld} command requires an argument---an output file name. @item An option and its argument may or may not appear as separate tokens. (In other words, the whitespace separating them is optional.) Thus, -@w{@samp{-o foo}} and @samp{-ofoo} are equivalent. +@w{@option{-o foo}} and @option{-ofoo} are equivalent. @item Options typically precede other non-option arguments. @@ -146,7 +146,7 @@ it, define the @code{_POSIX_OPTION_ORDER} environment variable. @xref{Standard Environment}. @item -The argument @samp{--} terminates all options; any following arguments +The argument @option{--} terminates all options; any following arguments are treated as non-option arguments, even if they begin with a hyphen. @item @@ -161,13 +161,13 @@ interpretation is left up to the particular application program. @cindex long-named options GNU adds @dfn{long options} to these conventions. Long options consist -of @samp{--} followed by a name made of alphanumeric characters and +of @option{--} followed by a name made of alphanumeric characters and dashes. Option names are typically one to three words long, with hyphens to separate words. Users can abbreviate the option names as long as the abbreviations are unique. To specify an argument for a long option, write -@samp{--@var{name}=@var{value}}. This syntax enables a long option to +@option{--@var{name}=@var{value}}. This syntax enables a long option to accept an argument that is itself optional. Eventually, @gnusystems{} will provide completion for long option names