From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pl1-f173.google.com (mail-pl1-f173.google.com [209.85.214.173]) by fantadrom.bsd.lv (OpenSMTPD) with ESMTP id c0c78545 for ; Sun, 30 Dec 2018 17:01:56 -0500 (EST) Received: by mail-pl1-f173.google.com with SMTP id gn14so12055172plb.10 for ; Sun, 30 Dec 2018 14:01:56 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=message-id:sender:date:from:to:cc:subject:references:mime-version :content-disposition:in-reply-to; bh=0NozNz3jYqe6UNfWqtkJpeLR/7LELnOhIdkpAryzdJo=; b=dTCHpn7ZfPrvnHauOIAZRjWP7uW+C81N5jk03VtXIGRUvi2roEUssz0e/FMrav3TAK /BCyZGht6fyf07r+9CiuJGWG+68pqe0FtNfqx/UrAtUcp1fMT36NmbMNT9pfSQ3KBn9p gxMhjIqNG+qgLnfet2tPi9UWQ9ftTdCcuNrGv2DrC2H2hwbwDwshUgmvbTVBenCz6ssM Q/RDq8LdyRnfvuhoLqLmOTuiyNufnTdFMGg5ZOz9jMXZFEbGyJHi2J/U/7Uu/plc9MlX YuwdgxJUHGIiawJQqq9Q8m5GZQ3Ns8q4DwFpR3OFWuQpleW4mNyJf4SnddfrQqdIqvTy KQXw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:message-id:sender:date:from:to:cc:subject :references:mime-version:content-disposition:in-reply-to; bh=0NozNz3jYqe6UNfWqtkJpeLR/7LELnOhIdkpAryzdJo=; b=P5uIEp3ahH9kb8koYwZ1bif/jg4OSs0OBHRRFlAj7FQlVuUk0phNYiDm9zjOIFggDv 0PlYb6cnUM0k1elRSdI6en+Gl0MiTvRWAr/yzodoZE742Ds9iprEpqhbCT1KtvBL2o20 xYjO/SVnNQzMXh00PDYGTwnWrtrNRv5t0rpoMntoSF8TfHrwVjvh58uRf6c+JuULm0Be BVix4yAfp084c+IZ5yHmufrJerWEZnkd5SSqbhpK0IJlb5OlDZqDO4O+LDz9cjUCsIYX 9K3Hv+cxF6w8B6at/goJhFSb9OaVC//CdRhtFZVwDXGFx/3O3Nb0uwYfuo7ou21KCKdL g0Ag== X-Gm-Message-State: AJcUukeEDrlnzpPpsq13+f5ospk4FmNkm2S1RfZOBXtykooneSGstj9s o0DhQvWvh6WQosa884vN7jDoHxWv X-Google-Smtp-Source: ALg8bN5Xf+rnL1GMZk3RjaZmqL933bBzCp3jdNVE7se3FAPO3upo3UjMZ5A4a1C7AFnYY7bPaW/+Hg== X-Received: by 2002:a17:902:20c8:: with SMTP id v8mr35809353plg.319.1546207314314; Sun, 30 Dec 2018 14:01:54 -0800 (PST) Received: from localhost ([2602:ae:1f04:9600:da71:b6f0:bbaf:b9bf]) by smtp.gmail.com with ESMTPSA id v14sm111591555pgf.3.2018.12.30.14.01.53 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Sun, 30 Dec 2018 14:01:53 -0800 (PST) Message-ID: <5c294051.1c69fb81.b2d07.5d7d@mx.google.com> Sender: John McKay Date: Sun, 30 Dec 2018 22:01:52 +0000 From: John McKay To: Ingo Schwarze Cc: discuss@mandoc.bsd.lv Subject: Re: Arch Linux Improvements References: <5c282663.1c69fb81.e8260.65b6@mx.google.com> <20181230025748.GJ98128@athene.usta.de> X-Mailinglist: mandoc-discuss Reply-To: discuss@mandoc.bsd.lv MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20181230025748.GJ98128@athene.usta.de> On Sun, 30 Dec 2018 03:57:48 +0100, Ingo Schwarze wrote: > So do not install them in the manpath. Install them somewhere else > where man(1) does not find them by default, for example below > /usr/share/doc/posix/man/ and instruct the few users who really > want to use man(1) for reading these pages to use > > $ man -M /usr/share/doc/posix/man > > > For example > > /usr/share/man/man3/freeaddrinfo.3p.gz > > /usr/share/man/man3/getaddrinfo.3.gz > > both contain entries for freeaddrinfo(3). > > Right, that is a totally broken installation. The manual page > system - neither the traditional one nor the mandoc implemation - > is not designed for mixing completely different things in the same > directory. Broken or not, it's the way that Arch Linux has set up their manual page page package. It looks like man-db makes it work by defining 5(!) different ways for it to look for the proper file depending on what layout it was told at compile time. Since their default man utility specifically supports the layout they use, I don't think they are going to be open to changing it. > If you have two pages that both match the name and the section > and that come from the same manpath, the selection is unspecified. > There is simply no way to select one or the other, they are identitical > in every respect, according to the search criteria. > > The solution is to not have contradictory manual pages in the same > tree. Keep your tree consistent. > > Manual pages have four properties: manpath (=tree), name, section, > architecture. If you have a four-tuple that matches two pages, you > cannot tell the two them apart. At least one of the four properties > must be different to be able to select one but not the other. > > If you have a broken tree containing conflicts, the best you can do > is use man -a and show all conflicting versions together. What about adding a new key that is just the section as derived from the file name? That would add to the size of the database but if you have a bad layout you can specify which page you actually want. It would be useful for Linux users as it seems many distributions will install manual pages under the same directory and expect the file name suffix to be a sufficient distinguisher because man-db allows for it. Thanks for pointing out the problems in my original plan. I was unaware that my original suggested change would cause such a problem. -- To unsubscribe send an email to discuss+unsubscribe@mandoc.bsd.lv