From nobody Thu Jun 9 07:17:02 2022 X-Original-To: freebsd-hackers@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id A6A1083D234 for ; Thu, 9 Jun 2022 07:17:04 +0000 (UTC) (envelope-from bapt@FreeBSD.org) Received: from smtp.freebsd.org (smtp.freebsd.org [96.47.72.83]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "smtp.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4LJb4w4JsLz4TF5; Thu, 9 Jun 2022 07:17:04 +0000 (UTC) (envelope-from bapt@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1654759024; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=VvOPiY2zP6mxXhMGLyt/llKbij/uh61McIPSVnPMLrQ=; b=ipcmVNaryF+pcitqi24yAIvjAycnwuc6vw8qiIR4BoWmTCdpKvnXpkr59aieC8MgBUO/pw lyPiJQj6x8vID3pkBzgnOQ7DGIiFboX6rO1FBXB+PogQcVxPQDs43Z1jUl9kUT4s2VLyfu XWGq6+C7ETeiARvQkwlOvIxYQuaRhQD5RfIOkXg8PE9Zw51krYQ3T9oj0urk7dVG0W0R70 AbhdL52FLslUIrYHbmSWhVfSqE/r8L4594EjqdX4KBaVBRlFDu+ExJnQS20u+Qe5bHYlwa czNqb/Ua/7SG9AaOFDCj2txLja9Q9Jn+uSoBLkBvYOfkBKAcj9Ru8937aQbIzQ== Received: from aniel.nours.eu (nours.eu [176.31.115.77]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) (Authenticated sender: bapt) by smtp.freebsd.org (Postfix) with ESMTPSA id 5AB35D2CB; Thu, 9 Jun 2022 07:17:04 +0000 (UTC) (envelope-from bapt@FreeBSD.org) Received: by aniel.nours.eu (Postfix, from userid 1001) id 4E9C6FE967; Thu, 9 Jun 2022 09:17:02 +0200 (CEST) Date: Thu, 9 Jun 2022 09:17:02 +0200 From: Baptiste Daroussin To: Steve Kargl Cc: freebsd-hackers@freebsd.org Subject: Re: mandoc and volume titles Message-ID: <20220609071702.umix3bbub3qxunlq@aniel.nours.eu> References: List-Id: Technical discussions relating to FreeBSD List-Archive: https://lists.freebsd.org/archives/freebsd-hackers List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-hackers@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1654759024; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=VvOPiY2zP6mxXhMGLyt/llKbij/uh61McIPSVnPMLrQ=; b=ZWR8487IIRH0V3KVPjznNxzLKs8Vb3mOZMWALwi2rTXsYOjvmRT3iHRVqifd/QQdVZF37j 95B0TxlpitJkNwhYDB/xSnGEmGgw+FoDTU3OtJx/Ko2e/acquEltT9AnZ+SexSaiaxzX/8 gq2yjmnYEbL0hrBKgU08e4jr4sv9RR018RmYh5QTnKvjSWDhAUxa+gRjxJcArf/7jvYMRX aGiylpuoPmUeFAEqPv0+Z01DPrzLiNnMzx1wkKlEKGYqBPo7ZfHmLw8EFYxvwnuZS7qgnR ZOUy/Wh5uQqaGcnxP50ItoCxIkC+Y94UaG6mlo1ajwupTTgncRR+TkY7IbFXrA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1654759024; a=rsa-sha256; cv=none; b=U3WURizr9TFFKjef4UyjKr6Iu/X0hlbZlxieFnDm6suOss0sSs9Mw7sOLrIs8RGEyVMtC1 Xu0CI99v+h28JhIMcSu97FOi4HLnT7W3f+y+7CbXEwMVN1F7C8b5G8hi6Cs3t9JXkjJE+B i+hzRdnu7ueMVC5GP3tfp1GGMo2hVjYEf58WP79Az1K1adUe3wBn2YOrok9AxGE4hl333O gmzc6Dw1xT1JRUPdAJoyY+ozeUCyifumrhjof1i+bZ37JiO3lNQ6URppgQyGBfori4E8Y3 3tRuH7iFVW+JkiN9rwdzXW5cjUZmezL27wgEPrWUGjojvq9i/HY+A0GpXvHOQQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N On Wed, Jun 08, 2022 at 04:35:08PM -0700, Steve Kargl wrote: > All, > > mandoc and mdoc(7) are a convenient system for writing > documentation, but it has a drawback. The volume > title is hardcoded to a FreeBSD manual page. For my > personal projects, I would like to change the volume > title. For example. > > % mandoc tier.1 | head -1 > TIER(1) FreeBSD General Commands Manual TIER(1) > > I have hacked up mandoc to accept a -V option, which allows e.g., > > % mandoc -V "Steve's Menagerie" tier.1 | head -1 > TIER(1) Steve's Menagerie TIER(1) > > I have created a bug report and attached the diff to it > if anyone is interested. > > https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=264560 Hello Steve, Regarding mandoc, I would like to keep it with as little custom patches as possible, regarding your patch, it sounds like a useful feature, have you considered talking directly to upstream about it to see if they are willing to integrate it directly? https://mandoc.bsd.lv/contact.html ? They are friendly and usually reactive. Best regards, Bapt