From owner-freebsd-ports-bugs@freebsd.org Sun May 6 01:07:50 2018 Return-Path: Delivered-To: freebsd-ports-bugs@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 642F4FC203F for ; Sun, 6 May 2018 01:07:50 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from mailman.ysv.freebsd.org (mailman.ysv.freebsd.org [IPv6:2001:1900:2254:206a::50:5]) by mx1.freebsd.org (Postfix) with ESMTP id ED67C79B64 for ; Sun, 6 May 2018 01:07:49 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: by mailman.ysv.freebsd.org (Postfix) id B101BFC203E; Sun, 6 May 2018 01:07:49 +0000 (UTC) Delivered-To: ports-bugs@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 8CEEAFC203D for ; Sun, 6 May 2018 01:07:49 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from mxrelay.ysv.freebsd.org (mxrelay.ysv.freebsd.org [IPv6:2001:1900:2254:206a::19:3]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "mxrelay.ysv.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 283C179B63 for ; Sun, 6 May 2018 01:07:49 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org (kenobi.freebsd.org [IPv6:2001:1900:2254:206a::16:76]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.ysv.freebsd.org (Postfix) with ESMTPS id 83FBE25135 for ; Sun, 6 May 2018 01:07:48 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org ([127.0.1.118]) by kenobi.freebsd.org (8.15.2/8.15.2) with ESMTP id w4617mMk004418 for ; Sun, 6 May 2018 01:07:48 GMT (envelope-from bugzilla-noreply@freebsd.org) Received: (from www@localhost) by kenobi.freebsd.org (8.15.2/8.15.2/Submit) id w4617mlp004417 for ports-bugs@FreeBSD.org; Sun, 6 May 2018 01:07:48 GMT (envelope-from bugzilla-noreply@freebsd.org) X-Authentication-Warning: kenobi.freebsd.org: www set sender to bugzilla-noreply@freebsd.org using -f From: bugzilla-noreply@freebsd.org To: ports-bugs@FreeBSD.org Subject: [Bug 227859] net/nncp docs do not build Date: Sun, 06 May 2018 01:07:48 +0000 X-Bugzilla-Reason: AssignedTo X-Bugzilla-Type: changed X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: Ports & Packages X-Bugzilla-Component: Individual Port(s) X-Bugzilla-Version: Latest X-Bugzilla-Keywords: X-Bugzilla-Severity: Affects Some People X-Bugzilla-Who: stargrave@stargrave.org X-Bugzilla-Status: New X-Bugzilla-Resolution: X-Bugzilla-Priority: --- X-Bugzilla-Assigned-To: ports-bugs@FreeBSD.org X-Bugzilla-Flags: maintainer-feedback? X-Bugzilla-Changed-Fields: Message-ID: In-Reply-To: References: Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Bugzilla-URL: https://bugs.freebsd.org/bugzilla/ Auto-Submitted: auto-generated MIME-Version: 1.0 X-BeenThere: freebsd-ports-bugs@freebsd.org X-Mailman-Version: 2.1.25 Precedence: list List-Id: Ports bug reports List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 06 May 2018 01:07:50 -0000 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D227859 --- Comment #9 from Sergey Matveev --- (In reply to p5B2E9A8F from comment #8) * info is not a standard in FreeBSD, man is. This is FreeBSD project decision exclusively, but I obviously see that man pages could not be replacement for info, at least because they lack links support and searching through the whole NNCP-related documentation. It means degradation of documentation's functionality/abilities. So if I would create man pages, then I forced to support two formats simultaneously: info for search/links capabilities (and HTML version for the website), man for satisfying FreeBSD's wishes. Here I do not agree with FreeBSD's decision. I am not some kind of GNU-fan, actually I really like BSD-world in nearly all cases, except for man-pages instead of info * HTML requires web-browser to be viewed on. It gives ability to link documents together, but still no ability to search, for example, for some word/term through the whole NNCP-related documentation. It is still not superiour comparing to info. Moreover FreeBSD does not have even lynx installed by default -- so you are anyway forced to install an additional software to the base system for viewing either HTML or info. But! Info can be viewed with more/less/cat/vi -- of course without search/links-following capabilities, but at least it would be perfectly readable * I understand and agreed that ideally man-pages should also be created, because man is installed by default and it is standard in FreeBSD. But it requires too much time I can afford for supporting them up. If there will be some kind of texi2man producing good man pages output, then I will do it. But I do not know such utilities. So I am forced to do double work. I think that this is acceptable to provide not so perfect .info (because info-viewer is not installed in FreeBSD by default, but installed in GNU OSes as a rule), that anyway can be viewed with more/cat/etc, for saving huge quantity of time spent on rewriting documentation simultaneously on man-pages * I still do not understand who HTML documentation could be included in version 2. Either I miss something, or you are mistaken. Port patch from 2.0 to 3.0 is: https://reviews.freebsd.org/file/data/pb2p4qzrkaae5marbypv/PHID-FILE-732x4z= 3zsne7yevyduzb/file I see nothing related to HTML-files installation that was thrown out. As I remember -- there was no HTML installation at all So, shortly: * there were no HTML docs in version 2 of the port. Maybe I miss something * HTML instead of info -- no. Info is superiour. Both of those formats require additional software installation. HTML additionally to info -- makes no sense, as both requires additional software. Info could be viewed with more/cat/etc, so even without additional software * man-pages additionally to info -- would be nice, but requires writing documentation twice, in two different formats. Can not afford due to time --=20 You are receiving this mail because: You are the assignee for the bug.=