Path: csiph.com!aioe.org!bofh.it!news.nic.it!robomod From: Olek Wojnar Newsgroups: linux.debian.maint.java Subject: Re: Kotlin: looking for a DD to review/upload Date: Tue, 04 May 2021 21:30:02 +0200 Message-ID: References: X-Mailbox-Line: From debian-java-request@lists.debian.org Tue May 4 19:24:20 2021 Old-Return-Path: X-Amavis-Spam-Status: No, score=-4.401 tagged_above=-10000 required=5.3 tests=[BAYES_00=-2, FOURLA=0.1, FREEMAIL_FORGED_FROMDOMAIN=0.249, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.25, HTML_MESSAGE=2, LDO_WHITELIST=-5, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001] autolearn=no autolearn_force=no X-Policyd-Weight: using cached result; rate: -5.5 X-Gm-Message-State: AOAM5329au7VS0IOswCd4eDDkzFcBZmOhk7IFjFQHAnC/hecPoAhQlnw yrujS2Yz4/pl6FiGzbjUfEqvkJ61pck= X-Google-SMTP-Source: ABdhPJztrfovgDgPRMQ2hMJLiCjfUNeqJNUUiB9JT1EesvKZuTrjTWRQiyPqrRzPFk/vtta8pdSHmQ== X-Received: by 2002:a05:620a:f94:: with SMTP id b20mr8302572qkn.300.1620155324897; Tue, 04 May 2021 12:08:44 -0700 (PDT) X-Received: by 2002:ac8:4a11:: with SMTP id x17mr18974005qtq.242.1620155324214; Tue, 04 May 2021 12:08:44 -0700 (PDT) MIME-Version: 1.0 X-Gmail-Original-Message-ID: Content-Type: multipart/alternative; boundary="00000000000094b21705c185ce2b" X-Mailing-List: archive/latest/22799 List-ID: List-URL: List-Archive: https://lists.debian.org/msgid-search/CAJj0crR0=gQA_yMJjGCmoC4cwiBKmcjZ_BkpogRXDT2EOOSnsA@mail.gmail.com Approved: robomod@news.nic.it Lines: 46 Organization: linux.* mail to news gateway Sender: robomod@news.nic.it X-Original-Date: Tue, 4 May 2021 15:08:32 -0400 X-Original-Message-ID: X-Original-References: <1e787344-9fd6-f082-a8f5-69e3492b4d47@tarent.de> Xref: csiph.com linux.debian.maint.java:12171 --00000000000094b21705c185ce2b Content-Type: text/plain; charset="UTF-8" On Sat, May 1, 2021 at 5:59 PM Thorsten Glaser wrote: > On Sat, 1 May 2021, Olek Wojnar wrote: > > > FWIW, help2man is often a really good starting point. > > REALLY not; that produces really bad-quality man(7)-format manpages. > > These days you want semantical markup via mdoc(7) instead (see, for > example, the manpage I wrote for jamulus or others). > Note that I didn't say it was a perfect solution, merely that it was a good starting point. :) Your point is certainly valid but I personally think that a man-format manpage that someone can quickly create is better than no manpage at all. -Olek --00000000000094b21705c185ce2b Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
On Sat, May 1, 2021 at = 5:59 PM Thorsten Glaser <t.glaser@tarent.de> wrote:
On= Sat, 1 May 2021, Olek Wojnar wrote:

> FWIW, help2man is often a really good starting point.

REALLY not; that produces really bad-quality man(7)-format manpages.

These days you want semantical markup via mdoc(7) instead (see, for
example, the manpage I wrote for jamulus or others).
<= br>
Note that I didn't say it was a perfect solution, merely = that it was a good starting point. :) Your point is certainly valid but I p= ersonally think that a man-format manpage=C2=A0that someone can quickly cre= ate is better than no manpage=C2=A0at all.

-Olek
--00000000000094b21705c185ce2b--