From owner-svn-src-head@freebsd.org Fri Oct 30 07:07:47 2020 Return-Path: Delivered-To: svn-src-head@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 485C744A206; Fri, 30 Oct 2020 07:07:47 +0000 (UTC) (envelope-from fernando.apesteguia@gmail.com) Received: from mail-qk1-f179.google.com (mail-qk1-f179.google.com [209.85.222.179]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "smtp.gmail.com", Issuer "GTS CA 1O1" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4CMtg621mWz4r61; Fri, 30 Oct 2020 07:07:46 +0000 (UTC) (envelope-from fernando.apesteguia@gmail.com) Received: by mail-qk1-f179.google.com with SMTP id x20so4070374qkn.1; Fri, 30 Oct 2020 00:07: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:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=QgdkWlKsbuXP3RuHqhXjEDqXapnHikFz1fl9QDjzEwM=; b=IBvVYc7GVYDmU/Y7CsiIimfxOUx7Wdg75iZEku0y8d93n9G/npX90HtK1PQ4oS1C77 btqeJPRZRzNOie563iBIZfkGFq/Y5+qPdLsNflQow3H8vAomnMq05y9NU6StN1pEQIA3 vvXwb1tZ8OmN4zvwfeQfwdVqj57xwsxc+NruG4RUOrX1DqtV5aSrIAE01rsdE3KePMQc mIFpMyWeNmTlsVAiu1TW8p189hMsmDEmVjSuR8jd6xhWxWd6bq0OaZrhFqN0noNCdYyE txzTotbbg9QMM+8lpI601oZ+n7Uuz0pfEUtUrdmPySUHPuOW+4LbAxeCCxtu0qaTSbgY +grg== X-Gm-Message-State: AOAM5320DA4SWg3jYrGH1wPwALkxTRdp47d519zcD/KA97+uKjL/Vf74 usxKBhcupentYSgKQLyC4OCLNc87w41bcQ== X-Google-Smtp-Source: ABdhPJyRm6ouy97D6G1puWNNJ//cF1AkY8Te+itz05IESjozyhJuNmQOU5G0O/BymmErFaG7Kv0eng== X-Received: by 2002:ae9:efd6:: with SMTP id d205mr829308qkg.410.1604041665066; Fri, 30 Oct 2020 00:07:45 -0700 (PDT) Received: from mail-yb1-f180.google.com (mail-yb1-f180.google.com. [209.85.219.180]) by smtp.gmail.com with ESMTPSA id l7sm460820qtp.31.2020.10.30.00.07.44 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Fri, 30 Oct 2020 00:07:44 -0700 (PDT) Received: by mail-yb1-f180.google.com with SMTP id b138so4303505yba.5; Fri, 30 Oct 2020 00:07:44 -0700 (PDT) X-Received: by 2002:a25:81d0:: with SMTP id n16mr1616749ybm.140.1604041664373; Fri, 30 Oct 2020 00:07:44 -0700 (PDT) MIME-Version: 1.0 References: <202010291837.09TIbKap040707@repo.freebsd.org> <5bc7ce7a-c5d4-21e5-7a7c-e381e66b2b2f@icloud.com> In-Reply-To: <5bc7ce7a-c5d4-21e5-7a7c-e381e66b2b2f@icloud.com> From: =?UTF-8?Q?Fernando_Apestegu=C3=ADa?= Date: Fri, 30 Oct 2020 10:05:50 +0100 X-Gmail-Original-Message-ID: Message-ID: Subject: Re: svn commit: r367142 - head/usr.bin/fmt To: xtouqh@icloud.com Cc: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org X-Rspamd-Queue-Id: 4CMtg621mWz4r61 X-Spamd-Bar: -- Authentication-Results: mx1.freebsd.org; dkim=none; dmarc=none; spf=pass (mx1.freebsd.org: domain of fernandoapesteguia@gmail.com designates 209.85.222.179 as permitted sender) smtp.mailfrom=fernandoapesteguia@gmail.com X-Spamd-Result: default: False [-2.79 / 15.00]; MIME_TRACE(0.00)[0:+,1:+,2:~]; RCVD_VIA_SMTP_AUTH(0.00)[]; RCVD_TLS_ALL(0.00)[]; FROM_HAS_DN(0.00)[]; RCPT_COUNT_THREE(0.00)[4]; R_SPF_ALLOW(-0.20)[+ip4:209.85.128.0/17]; NEURAL_HAM_LONG(-1.01)[-1.007]; MIME_GOOD(-0.10)[multipart/alternative,text/plain]; TO_DN_NONE(0.00)[]; ARC_NA(0.00)[]; DMARC_NA(0.00)[freebsd.org]; RCVD_COUNT_THREE(0.00)[4]; TO_MATCH_ENVRCPT_SOME(0.00)[]; NEURAL_HAM_SHORT(-0.83)[-0.832]; RCVD_IN_DNSWL_NONE(0.00)[209.85.222.179:from]; NEURAL_HAM_MEDIUM(-0.96)[-0.956]; FREEMAIL_TO(0.00)[icloud.com]; FORGED_SENDER(0.30)[fernape@freebsd.org,fernandoapesteguia@gmail.com]; RWL_MAILSPIKE_POSSIBLE(0.00)[209.85.222.179:from]; R_DKIM_NA(0.00)[]; FREEMAIL_ENVFROM(0.00)[gmail.com]; ASN(0.00)[asn:15169, ipnet:209.85.128.0/17, country:US]; FROM_NEQ_ENVFROM(0.00)[fernape@freebsd.org,fernandoapesteguia@gmail.com]; TAGGED_FROM(0.00)[]; MAILMAN_DEST(0.00)[svn-src-all,svn-src-head] Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Content-Filtered-By: Mailman/MimeDel 2.1.33 X-BeenThere: svn-src-head@freebsd.org X-Mailman-Version: 2.1.33 Precedence: list List-Id: SVN commit messages for the src tree for head/-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 30 Oct 2020 07:07:47 -0000 On Thu, Oct 29, 2020 at 7:47 PM wrote: > Fernando Apestegu=C3=ADa wrote: > > Author: fernape (ports committer) > > Date: Thu Oct 29 18:37:20 2020 > > New Revision: 367142 > > URL: https://svnweb.freebsd.org/changeset/base/367142 > > > > Log: > > fmt(1): Add EXAMPLES section > > > > Very small EXAMPLES section. > > > > While here, remove reference to nroff(1). > > > > Approved by: manpages (bcr@) > > Differential Revision: https://reviews.freebsd.org/D2694= 7 > > > > Modified: > > head/usr.bin/fmt/fmt.1 > > > > Modified: head/usr.bin/fmt/fmt.1 > > > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D > > --- head/usr.bin/fmt/fmt.1 Thu Oct 29 18:34:47 2020 (r367141) > > +++ head/usr.bin/fmt/fmt.1 Thu Oct 29 18:37:20 2020 (r367142) > > @@ -30,7 +30,7 @@ > > .\" > > .\" Modified by Gareth McCaughan to describe the new version of `fmt' > > .\" rather than the old one. > > -.Dd December 1, 2017 > > +.Dd October 29, 2020 > > .Dt FMT 1 > > .Os > > .Sh NAME > > @@ -89,10 +89,6 @@ Try to format mail header lines contained in the inp= ut > > Format lines beginning with a > > .Ql \&. > > (dot) character. > > -Normally, > > -.Nm > > -does not fill these lines, for compatibility with > > -.Xr nroff 1 . > > Was the behavior of fmt(1) really changed? If not, you could just > replace ".Xr nroff 1 ." with ".Nm nroff . ". > Hi, Thanks for reviewing the commit! In another revision I did something similar ( https://reviews.freebsd.org/D26146) (commit r366516) removing a BUGS section with details about nroff since it is not in base anymore. I got the impression that we should not refer to things that might (or might not) be installed from ports (see bcr@ comment in that review). I am not a docs committer and I don't know the policy here beyond those comments. But nevertheless if the paragraph has to be restored without cross reference, I'll do it :-) > > > .It Fl p > > Allow indented paragraphs. > > Without the > > @@ -159,10 +155,23 @@ environment variables affect the execution of > > .Nm > > as described in > > .Xr environ 7 . > > +.Sh EXAMPLES > > +Center the text in standard input: > > +.Bd -literal -offset indent > > +$ echo -e 'The merit of all things\enlies\enin their difficulty' | fmt > -c > > + The merit of all things > > + lies > > + in their difficulty > > +.Ed > > +.Pp > > +Format the text in standard input collapsing spaces: > > +.Bd -literal -offset indent > > +$ echo -e 'Multiple spaces will be collapsed' | fmt -s > > +Multiple spaces will be collapsed > > +.Ed > > .Sh SEE ALSO > > .Xr fold 1 , > > -.Xr mail 1 , > > -.Xr nroff 1 > > +.Xr mail 1 > > .Sh HISTORY > > The > > .Nm >