From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=0.2 required=5.0 tests=DKIM_INVALID,DKIM_SIGNED autolearn=no autolearn_force=no version=3.4.4 Received: (qmail 7918 invoked from network); 19 Jul 2021 22:49:04 -0000 Received: from bsd.lv (HELO mandoc.bsd.lv) (66.111.2.12) by inbox.vuxu.org with ESMTPUTF8; 19 Jul 2021 22:49:04 -0000 Received: from fantadrom.bsd.lv (localhost [127.0.0.1]) by mandoc.bsd.lv (OpenSMTPD) with ESMTP id 623e5b2c for ; Mon, 19 Jul 2021 17:49:01 -0500 (EST) Received: from wout3-smtp.messagingengine.com (wout3-smtp.messagingengine.com [64.147.123.19]) by mandoc.bsd.lv (OpenSMTPD) with ESMTP id b9a27124 for ; Mon, 19 Jul 2021 17:49:00 -0500 (EST) Received: from compute4.internal (compute4.nyi.internal [10.202.2.44]) by mailout.west.internal (Postfix) with ESMTP id 57B273200312 for ; Mon, 19 Jul 2021 18:48:59 -0400 (EDT) Received: from mailfrontend2 ([10.202.2.163]) by compute4.internal (MEProxy); Mon, 19 Jul 2021 18:48:59 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sgregoratto.me; h=date:from:to:subject:message-id:mime-version:content-type; s= fm3; bh=QlrT3iA1C4/dXe3fMA0qqGaRNNAaQeK9kAg2m30GSPc=; b=BYr1w7Sl n+SJXSoO2yLug4jbN2d3GDLlLYlcJ9vlA0VVhS/yppsNfG+hesnldQ7DOczv7/l4 yg/C/8rYgEGK3SiTbCBlhGJt2eMEfqw8PYSbqw3QfLwRFLK422GgYNsErUj5uQSR UeuejjzZV3cnkqx2Zc9xsvvjnPaBbQoBcdxobM1mGvS2uUS42xIg2iXatGIt9nNX f23gniIy2sc1J/fPNQnl8o/brgEXsf8cVb1XWLOw8EKRIuGdLjcMneFYEp2qe9ts 1FFFRmKgwKNjgxaPZrAjpK44IftSWEbbFY5tq5ryvDtzaGsvKreSQKrGMp58aM29 iJLFmjndP+czMg== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=content-type:date:from:message-id :mime-version:subject:to:x-me-proxy:x-me-proxy:x-me-sender :x-me-sender:x-sasl-enc; s=fm3; bh=QlrT3iA1C4/dXe3fMA0qqGaRNNAaQ eK9kAg2m30GSPc=; b=AA9uNEDg2OFADo1RQ7sDO3kuHGvsaTN9eJO/oXc93hmqm u6rxRG8HcNE2x4azSX8EnQIRLSsRZJO2K0RJE68RHK2tb1eBdZP8SYsBDfO03ved bnDqQAGCZ4n4aOTyxB24xb5dN05aQR/gLKA/HIn5wA4nPNneSSnA9QdnWF25C1q8 4B5TVyvBuPgtwFZE2G1/w45TGgpkOxLn4A9tutTIVqWHoEkRy9426pxdBZcLIAqS ofXi8ulFF7exmwsETxwqGpV2hUHDuBOEGGPbecoPt7KExEADRuf0H3Azz86XpYjO iu6xBHgcGemcZmsOGxEMTuYcOG9j4ZiPx8+eOh++Q== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvtddrfedugddutdcutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecunecujfgurhepfffhvffukfggtggusehttdertddttd ejnecuhfhrohhmpefuthgvphhhvghnucfirhgvghhorhgrthhtohcuoeguvghvsehsghhr vghgohhrrghtthhordhmvgeqnecuggftrfgrthhtvghrnhepudeghfekhfefkeelffeife fgvdffteeivdeukeffjeeffeeuudfhkeelffejieeinecuvehluhhsthgvrhfuihiivgep tdenucfrrghrrghmpehmrghilhhfrhhomhepuggvvhesshhgrhgvghhorhgrthhtohdrmh gv X-ME-Proxy: Received: by mail.messagingengine.com (Postfix) with ESMTPA for ; Mon, 19 Jul 2021 18:48:57 -0400 (EDT) Date: Tue, 20 Jul 2021 08:48:54 +1000 From: Stephen Gregoratto To: discuss@mandoc.bsd.lv Subject: mdoc synopsis style for more than one mandatory, mutually exclusive options? Message-ID: <20210719224854.hrmf3ez2oynitfe3@BlackBox> Mail-Followup-To: discuss@mandoc.bsd.lv X-Mailinglist: mandoc-discuss Reply-To: discuss@mandoc.bsd.lv MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline I am working on a utility that takes input from different sources: 1. Arguments after options parsing (i.e., after --). 2. From the named file after the `-R` flag. 3. From the named file after the `-I` flag. The program will quit if input == 0, so at least one of these options must be used. And there can be multiple instances of each (i.e., -R and -I can be specified more than once). My question is: how can I format this in the synopsis without it being overwhelming? Semantically, .Op is out because it isn't optional. I've seen other utilities use something like (a | -F b)... instead, but I've never seen this form in a manpage before. -- Stephen Gregoratto -- To unsubscribe send an email to discuss+unsubscribe@mandoc.bsd.lv