From owner-freebsd-questions@freebsd.org Tue May 23 17:43:09 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 72CE2D7ACE0; Tue, 23 May 2017 17:43:09 +0000 (UTC) (envelope-from luzar722@gmail.com) Received: from mail-it0-x232.google.com (mail-it0-x232.google.com [IPv6:2607:f8b0:4001:c0b::232]) (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 3A00E129B; Tue, 23 May 2017 17:43:09 +0000 (UTC) (envelope-from luzar722@gmail.com) Received: by mail-it0-x232.google.com with SMTP id g126so24529967ith.0; Tue, 23 May 2017 10:43:09 -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=Sl/clpFLUpEn7HNznYvKzGzj25bBJicJYgdX5HgFZb0=; b=vEUVcDC1ERAziDe375AHHNaDEk4yUlqtBuSDOUAfVCl7l233yX3gAknEnfjQyNgHhp Li16MBsQxdMzPSp7ZybPvvwqlL043UUmA7ye5rAWql+XGLRTZRNHgQZs7KndleAvV2wc /dUNaApApeTytMbssC6sTUo+6oVoxiEMyTRhtWciR3Pl9aRBqIhLjucS6TNwe5Lzq0fv iGyMS+2QeblhQI+wq8ewLxIKbg6Ivyuz15t6UDBO2hT0sWWqIlgOq1WcOPFgpM8Ra/kA wk9WPMAHClh+hcEU+FNORieFWoDDOPpiS8bH+4eF7ORuubzbr/Jlu9xH/pNwevUPHhZj FZkw== 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=Sl/clpFLUpEn7HNznYvKzGzj25bBJicJYgdX5HgFZb0=; b=ETbqLXIQHdj0TBFD9mOps0RgZdZgEJE3F9w3m7fABrm5y+Jb0z3lCK/6WoeDYnWIbg 7FRj6WENpnfKo+nbkPVYL3JzFlIYHQx2XBd7G52hOexEaB4pP007sB7Ely/RDYJFIsGH 0Pp0Qx0ScD12J6bvL4mU0r83uhYc6DkIri5KDpVs5HSFl95CaXTMdm0BttxbejQkP2V2 Ma0p2cWdvyDjzlQF4L0STQ/bk9LpOMLKwatAmVJJJKe+qto0dKBJUBAH8PpcTxr0l3My uuu6SuzBmbVgt5plPzi0JmTpR5Lc6i6Su5SE6G7Zn5SK5OKllsCgNEOI0bxilxSGMizW v6Eg== X-Gm-Message-State: AODbwcCcv243ilLXnub/Be9Av7sybo1OGntm7pTn5W0nDwFR0roDJBng pDCb1VdaB5RuXlJW X-Received: by 10.36.29.81 with SMTP id 78mr4098026itj.33.1495561388668; Tue, 23 May 2017 10:43:08 -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 l19sm564714ioe.3.2017.05.23.10.43.07 (version=TLS1 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Tue, 23 May 2017 10:43:08 -0700 (PDT) Message-ID: <592474C7.3070900@gmail.com> Date: Tue, 23 May 2017 13:43:35 -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> <59231887.7090100@gmail.com> <20170523024852.GV39245@kduck.kaduk.org> In-Reply-To: <20170523024852.GV39245@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: Tue, 23 May 2017 17:43:09 -0000 snip >>>> 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. > > `make DESTDIR=/path/to/web/root install` > > will install the compiled html files to the indicated path, but will > also leave a copy of them in the source (doc?) tree where you currently > don't like them. > > The one that I'm not entirely sure would work would be something > like > > `make MAKEOBJDIRPREFIX=/usr/obj/doc` > > which I guess would mirror the directory structure of the doc tree > checkout (using absolute paths!) inside /usr/obj/doc instead of > leaving html files in the source tree. But again, I did not test > that to check. > > MAKEOBJDIRPREFIX is documented in build(7). > For your information. I did many trial and error runs testing make DESTDIR=/root/htm.text install make MAKEOBJDIRPREFIX=/root/html.text make install -D /root/html.text In all cases the generated html code gets populated into the directory the make command was executed from and /root/html.text directory is left empty. But I discovered that issuing "make install" will cause the /usr/share/doc directory tree to be populated with the handbook html files. This is what I was after from the beginning. Just the html files by them selfs. I don't care where there at as long as its just the html files only. Other thing is "make clean" has to be issued between each cycle of "make install". One last thing. When I go to edit the chapter.xml content I see the text wraped in notation. Is there a special term that this "notation" is normally referred by?