From owner-freebsd-questions@freebsd.org Mon May 22 16:57:34 2017 Return-Path: Delivered-To: freebsd-questions@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 0183FD785F8; Mon, 22 May 2017 16:57:34 +0000 (UTC) (envelope-from luzar722@gmail.com) Received: from mail-it0-x241.google.com (mail-it0-x241.google.com [IPv6:2607:f8b0:4001:c0b::241]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "Google Internet Authority G2" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id BD3951137; Mon, 22 May 2017 16:57:33 +0000 (UTC) (envelope-from luzar722@gmail.com) Received: by mail-it0-x241.google.com with SMTP id i206so11878427ita.3; Mon, 22 May 2017 09:57:33 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=message-id:date:from:user-agent:mime-version:to:cc:subject :references:in-reply-to:content-transfer-encoding; bh=epdzDDlQxYt6D3iaLFWOSCNwRP7/qlKUaO/1OLUDUWE=; b=qykzAtd5opZfbw2NrNOI5bDqVTVpnVKCpgTgnGIdp4Fk6Lt5NRuP4odQFWJDhcMraY mHv7rvcSHm2EgDcCLDhncHeG/TUfRpOuhJqe/+onpMKRE3oJHuhlXfQ/4dnpoSsANWUy wlLuIs8jeXSkWXT2umOTukatAuOzUarr1LhuyjSZ19Y1wG93ZrOWaXK/qqFvn26A/7nL m80mfJ4OYzQhh6LkEbXzaIrbYFl9jGfnBaVX7babrRB7mXT39Sy+fG+QrKdBbWd11dVb lrnxn1iGNQz3dyYJ2nokjWpcgyM5T167ljjmdVkFr7RuvDtOR7Z/4JkAVp9XpLmHhWy8 j8aQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:message-id:date:from:user-agent:mime-version:to :cc:subject:references:in-reply-to:content-transfer-encoding; bh=epdzDDlQxYt6D3iaLFWOSCNwRP7/qlKUaO/1OLUDUWE=; b=hRNp91SqmE/QFjxbsxIbaLpFsBDR0mUlJ/o2+sw8lbcxM45L5nZ8ogN22TYSdscFHP jSJ0fD3HvdbxbvroKTRAQgZfmof1WUhZ5gSL0JwmUq2bnoz2cT8cyyyu/UzKuO5cm0Gt CJGiRLdV1fxAl+8axXXoPgG6nRDlQ7w3x4UPxyEHbhJ2hBFJBdT09iBUhqDR3asT3Tjy 8YYIwHo8bI3rRfH7hkkqEmwQ5hwgEKc1HnkaQufWKLDaN8TjjZAEi92xFRT3YRDGIW6Z WZdh40vKgBewZ0F9KZjvitUAKjz6BTYTZa9euboT2qG1E8yabbqWyg3bPACMEhqdbW2j 61aA== X-Gm-Message-State: AODbwcCQ7+5UIsEZjPNyWDHTtsDK1bIIQFPH+KCDlE6Kk4smGzIV3vj4 aEot4oBrwG7ZpA== X-Received: by 10.36.65.142 with SMTP id b14mr41523696itd.3.1495472253062; Mon, 22 May 2017 09:57:33 -0700 (PDT) Received: from [10.0.10.3] (cpe-74-141-88-57.neo.res.rr.com. [74.141.88.57]) by smtp.googlemail.com with ESMTPSA id e126sm7805059ioe.12.2017.05.22.09.57.32 (version=TLS1 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Mon, 22 May 2017 09:57:32 -0700 (PDT) Message-ID: <59231887.7090100@gmail.com> Date: Mon, 22 May 2017 12:57:43 -0400 From: Ernie Luzar User-Agent: Thunderbird 2.0.0.24 (Windows/20100228) MIME-Version: 1.0 To: Benjamin Kaduk CC: FreeBSD questions , "freebsd-doc@freebsd.org" Subject: Re: having trouble making changes to the handbook References: <592041FB.9030408@gmail.com> <20170522050544.GS39245@kduck.kaduk.org> In-Reply-To: <20170522050544.GS39245@kduck.kaduk.org> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-BeenThere: freebsd-questions@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: User questions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 22 May 2017 16:57:34 -0000 Benjamin Kaduk wrote: > On Sat, May 20, 2017 at 09:17:47AM -0400, Ernie Luzar wrote: >> I am following the info in this link >> https://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/ >> >> I installed the textproc/docproj package. >> >> The above link says that svn is installed as part of that port. But it >> really is not. Have to use the built in svnlite command. > > It seems that > https://svnweb.freebsd.org/ports/head/textproc/docproj/Makefile?revision=420130&view=markup > has some logic to not depend on devel/subversion when > /usr/bin/svnlite is present in the build environment, which is > arguably not the best choice, since the build environment need not > match the install environment when pre-built packages are in use. > > The above reply makes no sense to me. svnlite is included in the base OS release. So it's there in the build & install environment by default. Are you trying to say the textproc/docproj port is in error and should be fixed to install subversion as a dependent? I used the OS default svnlite to checkout the whole doc tree and manually updated the desired chapter source through creating the diff file without any problems. Please expand and clarify your point. >> The shown command >> "svnlite checkout https://svn.FreeBSD.org/doc/head ~/doc" >> downloads far more items than wanted. This needs better example of just >> downloading the desired language version of the handbook plus any >> "shared directories" required for "make command" to work. How do I do this? > > It is intentionally undocumented, as there are multiple parts from > the root needed to build a translation tree (in addition to the > english sources, which are used when translations do not exist). > No one has gone through to enumerate the list and commit to keeping > it up to date as the build system changes. That is to say, you are > free to attempt it, but it will require some investigation and it > will probably be simpler overall to just accept the extra bytes as > the cost of convenience. > > My post never voiced anything about the different translations of the English version of the handbook. There is a separate doc on translations. My interpretation of your reply is that it is technicality possible to checkout the desired handbook source based on language and them checkout the parts of the master doc tree needed to "make" the html code version. That to date, nobody has updated the https://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/ to include this information and I am free to do so. >> I ran the "igor -R filename.xml | less -RS" command on the chapter I >> wanted to work on before making any changes. To my surprise a bunch of >> error are shown. Since these error are all already in the handbook >> source I see no reason why I should try to correct them. > > Just because errors are preexisting they should be ignored instead > of fixed? To be clear, no one is going to insist that you fix all > issues in a file before adding content to it, but it is also a fine > idea to make an initial cleanup patch before starting to do further > work. > > As to how this situation might arise, the existing content is often > quite old, and igor is a comparatively new tool (and continues to > receive updates), so it is not surprising that there is old content > that does not fully comply to the current standards. > So "igor" is am independent application whose purpose is intended for informational use only. It does not inhibit the flow of making changes. It may be skipped all together. If something is really codded incorrectly the "make" process will fail with very limited feedback about the what it doesn't like and "igor" may used to help in the investigation to fix the problem. >> When I ran the "make" command the resulting html files are just written >> into the directory that "make" was run from. How do I tell "make" to >> write the output to a location of my selection? > > 'make install' should respect DESTDIR, of course, and I think (but > did not test) that the usual OBJDIR-manipulation variables would > work. > I take this to mean there are existing methods to point the html code generated by the make process to a separate path. Being brand new to changing content of the handbook I am un-familiar with the DESTIR and OBJDIR variables. Please provide an example of how to code it on the command line. >> What is really lacking is a way to view the changed output in a command >> line browser. Installing a desktop just to view the changed handbook is >> not an acceptable solution. > > But, what would the other location of your selection be that would > be differently viewable in a command-line browser than the html > files in the build tree? I generally use a browser (desktop or not) > to view the html files next to the xml sources, which is usually > "good enough" for what I need to do. > There is a very big difference between viewing the raw html or xml code in a command line editor and what one sees when shown by a browser. The ports system doesn't have a command line browser capable of displaying the handbook content. I ftp the new generated html code to my ms/xp box and view it using firefox. This method brings to light visual errors that are syntax correct but not what you really wanted. > -Ben > When I have complete knowledge of how to change the handbook I am planing to update the fdp-primer incorporating this new information. Thank you Ben for you help and guidance.