Re: [brlcad-devel] Questions on t/nroff man page conversion to xml
On Jun 11, 2012, at 8:53 PM, Tom Browder wrote: > On Sat, Jun 9, 2012 at 10:38 PM, Christopher Sean Morrison > wrote: > ... >> On Jun 9, 2012, at 10:13 AM, Tom Browder wrote: > ... >>> 1. Should the authors be changed to the standard as shown in the >>> docbook template? >> >> Yes and no. > > I'll take that as "more or less leave the principal author(s) in and > maybe add the BRL-CAD TEAM as it fits"? On the contrary, I've usually found any initial author list to be rather substantially incomplete. It usually doesn't reflect the dozen or more other people that have put in effort to maintain, debug, and preserve the tool, much less any subsequent developments. Basically, I think if we're going to name specific people in documentation, that we should attempt to document everyone (for that given tool) and categorize them under the AUTHORS categories (developer, code contributor, math/algo, and docs). That's a list that would then also need to be revisited every few years... That's why using BRL-CAD Team is a suitable alternative, since it implies everyone in the AUTHORS file. I wouldn't mix real names with a reference to the "Team". Cheers! Sean -- Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/ ___ BRL-CAD Developer mailing list brlcad-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/brlcad-devel
Re: [brlcad-devel] Questions on t/nroff man page conversion to xml
On Tue, Jun 12, 2012 at 8:59 AM, Christopher Sean Morrison wrote: ... Okey dokey. So on the first cut I'll leave authors as is unless the data look fuzzy and in those cases I'll substitute BRL-CAD TEAM. For sources with retained authors, would you like a final entry something like "(and others)" along with a source comment like "FIXME: look for other contributors"? -Tom -- Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/ ___ BRL-CAD Developer mailing list brlcad-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/brlcad-devel
Re: [brlcad-devel] Questions on t/nroff man page conversion to xml
On Jun 12, 2012, at 10:19 AM, Tom Browder wrote: > Okey dokey. So on the first cut I'll leave authors as is unless the > data look fuzzy and in those cases I'll substitute BRL-CAD TEAM. Sounds like the opposite of what I intended to convey.. ;) Unless it was a new tool written just this year, it's almost guaranteed that any current list of authors is woefully incomplete. So the point was replacing them with BRL-CAD Team is fine. More than fine, it's a good thing to do since missing authorship is paramount to incorrect docs (not just incomplete docs). The only thing better would be a comprehensive credit list derived from repo history, commit notes, publications, etc. Getting that comprehensive list is a complex task in itself. Keeping it current would be even harder. > For sources with retained authors, would you like a final entry > something like "(and others)" along with a source comment like "FIXME: > look for other contributors"? No, the point was if we list anyone, we need to list everyone. Where we aren't sure, it should just list BRL-CAD Team. For most tools, that means replacing the initial author list and that's a good thing. Even doing that for all tools would be fine (because it's never incorrect). Cheers! Sean -- Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/ ___ BRL-CAD Developer mailing list brlcad-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/brlcad-devel
Re: [brlcad-devel] Questions on t/nroff man page conversion to xml
On Tue, Jun 12, 2012 at 9:44 AM, Christopher Sean Morrison wrote: > On Jun 12, 2012, at 10:19 AM, Tom Browder wrote: > >> Okey dokey. So on the first cut I'll leave authors as is unless the >> data look fuzzy and in those cases I'll substitute BRL-CAD TEAM. > > Sounds like the opposite of what I intended to convey.. ;) Sorry, feeble mind. > So the point was replacing them with BRL-CAD Team is fine. More than fine, > it's a good thing to do since missing authorship is paramount to incorrect > docs > (not just incomplete docs). > The only thing better would be a comprehensive credit list derived from repo > history, commit notes, publications, etc. Getting that comprehensive list is > a complex task in itself. Keeping it current would be even harder. ... > No, the point was if we list anyone, we need to list everyone. > Where we aren't sure, it should just list BRL-CAD Team. > For most tools, that means replacing the initial author list and that's a > good thing. > Even doing that for all tools would be fine (because it's never incorrect). Gotcha'...I think. Let me get some specifics later. Best, -Tom -- Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/ ___ BRL-CAD Developer mailing list brlcad-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/brlcad-devel
[brlcad-devel] Installing from Source: Makefile Problem
I am trying to install BRLCAD from source. I successfully run ./configure. Next step is to run make command. But on executing it, I got the following error: make: *** No targets specified and no makefile found. Stop. But I can see two Makefiles in the current directory: Makefile.in and Makefile.am When specify Makefile.in as Makefile to make command, I got Makefile.in:16: *** missing separator. Stop. When Makefile.am is used as Makefile similar error occured: Makefile.am:57: *** missing separator. Stop. What can be the solution? -- Harmanpreet Singh -- Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/ ___ BRL-CAD Developer mailing list brlcad-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/brlcad-devel
Re: [brlcad-devel] Installing from Source: Makefile Problem
On Tue, Jun 12, 2012 at 11:13 PM, Harmanpreet Singh wrote: > I am trying to install BRLCAD from source. I successfully run > ./configure. Actually I didn't run it successfully. There was error stating "libpng disabled". I rerun ./configure with option of enabling libpng and afterwards, "make" run successfully. Now while running "make test" and "make benchmark", I got following errors: primitives/nmg/nmg_tri.c: In function 'nmg_plot_fu': primitives/nmg/nmg_tri.c:2531:13: error: variable 'temp' set but not used [-Werror=unused-but-set-variable] primitives/nmg/nmg_tri.c:2530:13: error: variable 'dist_btw_prev_curr' set but not used [-Werror=unused-but-set-variable] primitives/nmg/nmg_tri.c: In function 'nmg_triangulate_rm_holes': primitives/nmg/nmg_tri.c:2754:29: error: variable 'vu2' set but not used [-Werror=unused-but-set-variable] cc1: all warnings being treated as errors make[2]: *** [nmg_tri.lo] Error 1 make[1]: *** [all-recursive] Error 1 make: *** [all-recursive] Error 1 Seems problem with some variables. Do they need to be unset? If yes, any hint? -- Harmanpreet Singh -- Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/ ___ BRL-CAD Developer mailing list brlcad-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/brlcad-devel
