Date: Tue, 23 May 2017 13:43:35 -0400 From: Ernie Luzar <luzar722@gmail.com> To: Benjamin Kaduk <kaduk@mit.edu> Cc: FreeBSD questions <freebsd-questions@FreeBSD.org>, "freebsd-doc@freebsd.org" <freebsd-doc@FreeBSD.org> Subject: Re: having trouble making changes to the handbook Message-ID: <592474C7.3070900@gmail.com> In-Reply-To: <20170523024852.GV39245@kduck.kaduk.org> References: <592041FB.9030408@gmail.com> <20170522050544.GS39245@kduck.kaduk.org> <59231887.7090100@gmail.com> <20170523024852.GV39245@kduck.kaduk.org>
next in thread | previous in thread | raw e-mail | index | archive | help
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?
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?592474C7.3070900>