From mboxrd@z Thu Jan 1 00:00:00 1970 From: Chris Marusich Subject: Re: Hwo to debug and teacking builds? Date: Tue, 28 Mar 2017 23:10:46 -0700 Message-ID: <87vaqsfw9l.fsf@gmail.com> References: <58DA29EC.30008@crazy-compilers.com> <8737dx7mpb.fsf@gnu.org> Mime-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha256; protocol="application/pgp-signature" Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:36524) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ct6ol-0003nf-Cd for help-guix@gnu.org; Wed, 29 Mar 2017 02:10:52 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ct6ok-0003Oq-DU for help-guix@gnu.org; Wed, 29 Mar 2017 02:10:51 -0400 List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-guix-bounces+gcggh-help-guix=m.gmane.org@gnu.org Sender: "Help-Guix" To: Catonano Cc: help-guix --=-=-= Content-Type: text/plain Content-Transfer-Encoding: quoted-printable Catonano writes: > This is important information and it's more detailed than what Pjotr wrot= e in his wrap up=20 > > I'd do it myself but I don't know the first thing about the info system > > Which is the source file ?=20 I'm sure your contribution would be welcome! The source is in guix/doc, mostly in guix.texi. > How do I compile it ? Get the dependencies: guix environment guix --ad-hoc texlive Make everything: make Make just the documentation, in Info format: make info If you're curious to understand why these targets exist, please refer to the Automake manual for details: https://www.gnu.org/software/automake/manual/automake.html#Documentation After making changes to the guix.texi file, just re-run the 'make' invocation, and it will quickly recompile just the documentation. To view your changes, it's helpful to add the 'guix/doc' directory from your local Guix checkout to your INFOPATH. I've put the following line in my ~/.bash_profile to do this automatically: export INFOPATH=3D"$HOME/guix/doc${INFOPATH:+:}$INFOPATH" That way, when you invoke 'guix info' (or 'C-h i' in Emacs), you'll see the updated version. I don't know how to preview changes in real-time as you modify guix.texi, but if you learn how, please let me know! > Which Emacs mode should I use ? Try texinfo-mode (see: (texinfo) Emacs Editing). =2D-=20 Chris --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAEBCAAdFiEEy/WXVcvn5+/vGD+x3UCaFdgiRp0FAljbT+YACgkQ3UCaFdgi Rp2vAhAA2iRvboW38aelv9r9cPc0VSzKncFCo3dSRrkpsGAyJo4JLGpT2nKVuqEH aRfX1zDwyb05oEiqhcaWB3Iz9DaPZRy+oY+BQ7Oj+eq98LdEQGXD6cDFch5JA35a KNzF1JMgr7oGVVZBtRQUYFB2WPRqcEttqkhGJ4dLGgZnzq/vtiE4bXT7IYuZ4kzP tUtorKflII9vEWZjXmpbA6tjvRlwiWhofQBRIO7YWDgAhs1OP61Xa4xv2hOsUgYR qu82J6oxn9WSBPx/x4/XodGnO7xziRU5DmsgHJedLogZZlb7iyiK94ml4gEQ4HFj klvPdtrTlP0mSvjJkgu0JPLljhnqQG91qrRtneIT4Ma+vii/ILFNC7ONV2PCZVO8 25+VTFLE9aio7vZ7p7xvUg192dujGh2bEqhElGrl40CP+RX8Tch2hcl9QEwwQ81u /ZnJE6PFEDhlc41Tq5xgotRRkIqaVIkeAWCqgBmFkgeNj8HIX1JolCt/z3YfXrDi j0Bk/TDMxK0pUkhBX/O7DDL2KiK3dL48TJSUSDEQUR9HdcqAdaL75JAS+8JGpgrY Hpk4V+icz2jPgGZkzv37YqWi5b74KjJGfGfIsbfIv2riEsD2CLNCp7KSbI7WMrH0 Otmd3iM8Il/zDbjUrVnNBLCW5CDFd33Dh8U3icl/xziv+/Nrtpo= =Q/s7 -----END PGP SIGNATURE----- --=-=-=--