Re: [gentoo-dev] Unofficial Gentoo Development Guide and Autotools
maillog: 20/05/2005-06:06:21(+0100): Ciaran McCreesh types On Thu, 19 May 2005 04:44:25 +0100 Ciaran McCreesh [EMAIL PROTECTED] wrote: | http://www.firedrop.org.uk/devmanual/general-concepts/autotools/ Updated based upon the feedback, thanks guys. If someone who's relatively clueless about autotools could give it a read and let me know what is and isn't clear I'd appreciate it. That would be me. Notes: - typo? - The configure script is run to produce one or Makefile files from Makefile.in files. + The configure script is run to produce one or more Makefile files from Makefile.in files. - clarification AC_MSG_CHECKING(--enable-cscope argument) AC_ARG_ENABLE(cscope, [ --enable-cscope Include cscope interface.], [enable_cscope=$enableval], [enable_cscope=no]) AC_MSG_RESULT($enable_cscope) if test $enable_cscope = yes; then AC_DEFINE(FEAT_CSCOPE) fi 1 paragraph skipped Important: The third argument is used when an option is specified, and the fourth is used when an option is not specified. A common misconception is that the third is enable and the fourth is disable this is not the case. You may encounter packages that get this wrong. The phrase when an option is specified is a bit ambiguous, especially since it is later referred by the explanation of AC_ARG_WITH. I was not sure if option in this case means option as in --enable-foo=OPTION. I was confused, because one paragarph before the example you talk about --enable-foo and --disable-foo *switches* to ./configure. Maybe the above can be written as: The third argument is used when either --enable or --disable is specified, and the fourth is used when neither is specified. Or you could simply stick to using switches instead of options? - coloring %.1 : %.in @regex_cmd@ -e s,[EMAIL PROTECTED]@,$(VERSION),g $? $@ The first @ is span.Special and the second one is span.Constant. Good job by the way. -- () Georgi Georgiev () There is only one thing in the world worse () ()[EMAIL PROTECTED]() than being talked about, and that is not () () +81(90)2877-8845 () being talked about. -- Oscar Wilde () pgp8Phc1VyZhW.pgp Description: PGP signature
Re: [gentoo-dev] Unofficial Gentoo Development Guide and Autotools
On Fri, 20 May 2005 15:06:12 +0900 Georgi Georgiev [EMAIL PROTECTED] wrote: | - The configure script is run to produce one or Makefile files | from Makefile.in files. | + The configure script is run to produce | one or more Makefile files from Makefile.in files. Gah! I'm sure I'd already fixed that one... | The phrase when an option is specified is a bit ambiguous, | especially since it is later referred by the explanation of | AC_ARG_WITH. I was not sure if option in this case means option as | in --enable-foo=OPTION. I was confused, because one paragarph before | the example you talk about --enable-foo and --disable-foo *switches* | to ./configure. .. Important:: The third argument is used when a ``--enable`` or ``--disable`` switch to ``./configure`` is provided, and the fourth is used when such a switch is *not* passed. A common misconception is that the third is enable and the fourth is disable -- this is **not** the case. You may encounter packages that get this wrong. Does that sound any better? | - coloring | | %.1 : %.in | @regex_cmd@ -e s,[EMAIL PROTECTED]@,$(VERSION),g $? $@ | | The first @ is span.Special and the second one is span.Constant. Hrm, that's a vim thing (I'm using a vim script to do the highlighting at compile time, it's not manual). If someone enjoys pain they could have a go at making vim's automake highlighting smarter... Don't think I'm brave enough to touch that one myself. Thanks, -- Ciaran McCreesh : Gentoo Developer (Vim, Shell tools, Fluxbox, Cron) Mail: ciaranm at gentoo.org Web : http://dev.gentoo.org/~ciaranm pgp4NMEc6HETO.pgp Description: PGP signature
Re: [gentoo-dev] Unofficial Gentoo Development Guide and Autotools
On Fri, 20 May 2005 18:01:04 +0900 Georgi Georgiev [EMAIL PROTECTED] wrote: | | %.1 : %.in | | @regex_cmd@ -e s,[EMAIL PROTECTED]@,$(VERSION),g $? $@ | | | | The first @ is span.Special and the second one is span.Constant. | | Hrm, that's a vim thing (I'm using a vim script to do the | highlighting at compile time, it's not manual). If someone enjoys | pain they could have a go at making vim's automake highlighting | smarter... Don't think I'm brave enough to touch that one myself. | | The 2html.vim that comes with vim seems to work fine here. Tried both | 7__ and 6.3. The HTML is ugly, but at least it's properly highlighted: | | http://gg3.net/~chutz/gentoo/highlight/ | | Of course, you need to set ft=automake, which is different than | ft=make. ;) That's only working because you're indenting using spaces rather than tabs. If you indent using tabs you'll get the mixed colouring. -- Ciaran McCreesh : Gentoo Developer (Vim, Shell tools, Fluxbox, Cron) Mail: ciaranm at gentoo.org Web : http://dev.gentoo.org/~ciaranm pgpwdBL1vLriN.pgp Description: PGP signature
Re: [gentoo-dev] Unofficial Gentoo Development Guide and Autotools
maillog: 20/05/2005-10:29:53(+0100): Ciaran McCreesh types On Fri, 20 May 2005 18:01:04 +0900 Georgi Georgiev [EMAIL PROTECTED] wrote: | | %.1 : %.in | | @regex_cmd@ -e s,[EMAIL PROTECTED]@,$(VERSION),g $? $@ | | | | The first @ is span.Special and the second one is span.Constant. | | Hrm, that's a vim thing (I'm using a vim script to do the | highlighting at compile time, it's not manual). If someone enjoys | pain they could have a go at making vim's automake highlighting | smarter... Don't think I'm brave enough to touch that one myself. | | The 2html.vim that comes with vim seems to work fine here. Tried both | 7__ and 6.3. The HTML is ugly, but at least it's properly highlighted: | | http://gg3.net/~chutz/gentoo/highlight/ | | Of course, you need to set ft=automake, which is different than | ft=make. ;) That's only working because you're indenting using spaces rather than tabs. If you indent using tabs you'll get the mixed colouring. O, so true, so true... I am trying to redeem myself with the following. Care to give it a try? --- /usr/share/vim/vim70aa/syntax/automake.vim.old 2005-05-20 19:05:09.0 +0900 +++ /usr/share/vim/vim70aa/syntax/automake.vim 2005-05-20 19:07:05.0 +0900 @@ -43,6 +43,7 @@ syn region automakeMakeDString start=++ skip=+\\+ end=++ contains=makeIdent,automakeSubstitution syn region automakeMakeSString start=+'+ skip=+\\'+ end=+'+ contains=makeIdent,automakeSubstitution syn region automakeMakeBString start=+`+ skip=+\\`+ end=+`+ contains=makeIdent,makeSString,makeDString,makeNextLine,automakeSubstitution +syn region makeCommands start=;hs=s+1 start=^\t end=^[^\t#]me=e-1,re=e-1 end=^$ contained contains=makeCmdNextLine,makeSpecial,makeComment,makeIdent,makePreCondit,makeDefine,makeDString,makeSString,autoMakeSubst,automakeMakeError,automakeBadSubst nextgroup=makeCommandError Define the default highlighting. For version 5.7 and earlier: only when not done already -- /\ Georgi Georgiev /\ Be not anxious about what you have, but /\ \/[EMAIL PROTECTED]\/ about what you are. -- Pope St. Gregory I\/ /\ +81(90)2877-8845 /\ /\ pgpl8EQHZEjAs.pgp Description: PGP signature
Re: [gentoo-dev] Unofficial Gentoo Development Guide and Autotools
On Fri, 20 May 2005 19:11:13 +0900 Georgi Georgiev [EMAIL PROTECTED] wrote: | O, so true, so true... | | I am trying to redeem myself with the following. Care to give it a | try? Pretty close, thanks. I think I'll adapt it a bit to define a cluster in make.vim and then add to that cluster in automake.vim rather than just overriding the entire rule. That way if make.vim is ever updated we'll either carry on working or get a nice visible patch failure rather than silent weirdness. Bug 93378 if you want to track it. I'll be doing new vim6 and 7 snapshots soon from the looks of things, so I'll include it then. -- Ciaran McCreesh : Gentoo Developer (Vim, Shell tools, Fluxbox, Cron) Mail: ciaranm at gentoo.org Web : http://dev.gentoo.org/~ciaranm pgp7qHRs1zmHY.pgp Description: PGP signature
Re: [gentoo-dev] Unofficial Gentoo Development Guide and Autotools
On Thu, 2005-05-19 at 04:44 +0100, Ciaran McCreesh wrote: Do you like the picture? Feedback please. I do like the picture. It's a very pretty picture. However, some explanation of libtool would be nice, if only because it's so good at breaking in new and inventive ways. -- gentoo-dev@gentoo.org mailing list
Re: [gentoo-dev] Unofficial Gentoo Development Guide and Autotools
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Mike Frysinger wrote: On Thursday 19 May 2005 02:59 pm, Mike Frysinger wrote: then if it works, it will add '-lmng' to LDFLAGS ... err, no it doesnt ... it adds -lmng to MNG_LIBS which is updated in Makefile's with AC_SUBST() ... -mike I meant to say it adds it to the linking flags when mng is needed. That wasn't quite what came out.. does this mean I'm FACED? Chris White -BEGIN PGP SIGNATURE- Version: GnuPG v1.4.0 (GNU/Linux) Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org iD8DBQFCjO09FdQwWVoAgN4RAtQfAJ9IxJegWQZZciXb5cVL3HqOhrdnqACgzBkG BX/rSl0vp7fpw5kFE+d/NAY= =rbS8 -END PGP SIGNATURE- -- gentoo-dev@gentoo.org mailing list
Re: [gentoo-dev] Unofficial Gentoo Development Guide and Autotools
On Thursday 19 May 2005 03:47 pm, Chris White wrote: Mike Frysinger wrote: On Thursday 19 May 2005 02:59 pm, Mike Frysinger wrote: then if it works, it will add '-lmng' to LDFLAGS ... err, no it doesnt ... it adds -lmng to MNG_LIBS which is updated in Makefile's with AC_SUBST() ... -mike I meant to say it adds it to the linking flags when mng is needed. That wasn't quite what came out.. does this mean I'm FACED? it certainly does, deal with it -mike -- gentoo-dev@gentoo.org mailing list
Re: [gentoo-dev] Unofficial Gentoo Development Guide and Autotools
On Thu, 19 May 2005 04:44:25 +0100 Ciaran McCreesh [EMAIL PROTECTED] wrote: | http://www.firedrop.org.uk/devmanual/general-concepts/autotools/ Updated based upon the feedback, thanks guys. If someone who's relatively clueless about autotools could give it a read and let me know what is and isn't clear I'd appreciate it. There're still lots of things that could be improved, of course, but I reckon it's probably more helpful if I start tidying up other areas some more rather than spending huge amounts of time getting that one page perfect. Oh, I killed the yellow/purple. And updated the picture! -- Ciaran McCreesh : Gentoo Developer (Vim, Shell tools, Fluxbox, Cron) Mail: ciaranm at gentoo.org Web : http://dev.gentoo.org/~ciaranm pgpxigYr7Jzj6.pgp Description: PGP signature
Re: [gentoo-dev] Unofficial Gentoo Development Guide and Autotools
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Ciaran McCreesh wrote: http://www.firedrop.org.uk/devmanual/general-concepts/autotools/ What more would people like to see explained? Is there anything in there that needs changing or clarifying? Anything that's just plain wrong? Does it need a section on libtool and if so does someone want to explain to me how the heck it works? Are there good examples of ebuilds which make understandable changes to these things that I should be adding as illustrations? Do you like the picture? Feedback please. I'd like to see a starter on how m4 works. After that, I have a feeling the rest of the content will be much easier to talk about. It's also probably worth linking to the autobook for more info. http://vipe.technion.ac.il/~shlomif/lecture/Autotools/slides/ seems pretty nice too. Thanks for your hard work on this! Donnie -BEGIN PGP SIGNATURE- Version: GnuPG v1.4.1 (GNU/Linux) iD8DBQFCjCPAXVaO67S1rtsRAhLmAJ9oWCUMTGbgnwF8N5fEoNOJNV3rHACffkIN wvuNX+QsGC/VHaH5H4V/nfQ= =Ia0a -END PGP SIGNATURE- -- gentoo-dev@gentoo.org mailing list
Re: [gentoo-dev] Unofficial Gentoo Development Guide and Autotools
On Wednesday 18 May 2005 11:44 pm, Ciaran McCreesh wrote: What more would people like to see explained? might be useful to have a brief 'syntax' section ... one that covers different 'features' of the m4 language ... for example, [] are used for quotes and if you try to use , they are actually passed through ... AC_MSG_RESULT([eat me]) AC_MSG_RESULT(eat me) the second one will actually output the quotes which is often unexpected behavior for many new autotool hackers -mike -- gentoo-dev@gentoo.org mailing list
