| 00:17.04 | maths22 | I've created a docbook browser |
| 00:17.04 | maths22 | http://brlcad.org/docbrowser/svnDocbook/Documents/browse/doc/docbook/ |
| 00:17.23 | maths22 | xml files have a view documentation link that will render it |
| 00:59.45 | Notify | 02GCI:zehata * 5032082837340160 : Ready for review - The work on this task is ready to be reviewed. |
| 01:01.43 | *** join/#brlcad kintel (~kintel@unaffiliated/kintel) |
| 01:18.55 | Notify | 02GCI:maths22_m * 6452933096898560 : Task Assigned - This task has been assigned to RI. You have 100 hours to complete this task, good luck! |
| 02:14.01 | Notify | 02GCI:Melange * 4956557716488192 : Task Reopened - Melange has detected that the final deadline has passed and it has reopened the task. |
| 02:15.17 | *** join/#brlcad Techtronix (~Techtroni@117.200.84.34) |
| 02:24.26 | Notify | 02GCI:quentindhs * 5874616018927616 : help - Hi Issac I'm not sure how to proceed from Step 3, as neither BRL-CAD nor CMake have anything called "gcirocks.ebm ebm hello bw 512 512 64", nor does... |
| 03:03.58 | Notify | 02GCI:judebirch * 6383010643443712 : Done - I worked out how to make groups. I hope this is good enough! |
| 03:04.34 | Notify | 02GCI:judebirch * 6383010643443712 : Ready for review - The work on this task is ready to be reviewed. |
| 03:07.41 | *** join/#brlcad mihaineacsu (~mihaineac@92.81.146.119) |
| 03:09.14 | Notify | 02GCI:quentindhs * 5874616018927616 : Claim Removed - The claim on this task has been removed, someone else can claim it now. |
| 18:21.31 | *** join/#brlcad infobot (ibot@rikers.org) |
| 18:21.31 | *** topic/#brlcad is Topic for #brlcad: BRL-CAD || http://brlcad.org || logs: http://ibot.rikers.org/%23brlcad/ || Welcome GCI 2014 participants! If you're participating, be patient when asking questions... we're very busy and sometimes have packed schedules. We will respond if you are still on IRC: learn screen+irssi. |
| 18:33.26 | *** join/#brlcad teepee (~teepee@gateway/tor-sasl/teepee) |
| 18:38.03 | *** join/#brlcad alisha (~alisha@101.60.151.61) |
| 18:46.19 | *** join/#brlcad FreezingCold (~FreezingC@135.0.41.14) |
| 18:48.57 | *** join/#brlcad kintel (~kintel@unaffiliated/kintel) |
| 18:55.56 | starseeker | maths22: hah, cool! |
| 18:59.17 | starseeker | (DocBook viewer) |
| 19:02.03 | andromeda-galaxy | starseeker: since I'm kind of running out of tasks, I'm working on one of the Doxygen cleanup ones (libbu); does doxygen warn about functions not in any group? Fixing the warnings shouldn't be too hard, but I'm not sure how to ensure that all of the functions are organized correctly |
| 19:02.40 | starseeker | erm |
| 19:02.44 | starseeker | one sec... |
| 19:02.48 | starseeker | (task link?) |
| 19:04.17 | andromeda-galaxy | starseeker: sorry, https://www.google-melange.com/gci/task/view/google/gci2014/6391391198380032 |
| 19:04.17 | gcibot | Doxygen cleanup for LIBBU || BRL-CAD || Claimed (4 days 2 hrs 41 min) || Isaac Kamga, Hardeep Singh Rai |
| 19:06.02 | starseeker | are we out of the NACA tasks? I remember you got three of the tests working... |
| 19:06.57 | starseeker | andromeda-galaxy: ok, first order of business about that task - it looks like it got imported from last year and is a bit dated |
| 19:07.49 | starseeker | misc/doxygen/* files are the current home of the Doxygen structure management |
| 19:08.37 | starseeker | to build our Doxygen output, you need to have doxygen installed. If it is, a "make dox" should build the documentation. |
| 19:08.53 | starseeker | it will take quite a while, which is why that target is not part of the normal build |
| 19:09.37 | andromeda-galaxy | starseeker: makes sense, I got as far as running 'make dox', which generates lots of warnings, which don't look too hard to fix |
| 19:10.00 | andromeda-galaxy | (and we are out of NACA tasks for now, the batch with the new ones hasn't been pushed yet) |
| 19:10.28 | andromeda-galaxy | but I was wondering about how to check that all the functions are in reasonable groups as specified by the second part of the task... |
| 19:12.50 | starseeker | andromeda-galaxy: that's a bit subjective |
| 19:13.20 | starseeker | if you look at the html output generated by doxygen, you should see the libbu functions grouped into categories |
| 19:14.10 | starseeker | I haven't looked recently (I'm building the dox target now but this machine is on the slow side) but I think a lot of organization work was done after that task was written |
| 19:14.44 | starseeker | so the key is to review the groupings to make sure things are where they are supposed to be, and see if any of the groups look like they probably should be sub-groups |
| 19:14.59 | starseeker | feel free to ask/discuss on the channel if there is any question |
| 19:17.58 | starseeker | andromeda-galaxy: ah - try the build target libdox |
| 19:18.02 | starseeker | make libdox |
| 19:18.15 | andromeda-galaxy | right... |
| 19:18.27 | andromeda-galaxy | is there any way to get a list of functions that aren't correctly categorized? |
| 19:18.40 | starseeker | I'm hoping that'll be clear in the output |
| 19:18.57 | andromeda-galaxy | hope so... I'll take another look at it, hopefully there's somew ay to get at the "no modules". |
| 19:19.04 | andromeda-galaxy | what's the difference between dox and libdox? |
| 19:19.18 | Notify | 03BRL-CAD:n_reed * 63854 brlcad/trunk/src/tclscripts/archer/Archer.tcl: give preference methods more intuitive names |
| 19:19.20 | starseeker | if not, you may have to review the individual subheaders |
| 19:19.32 | starseeker | but let's see what the output looks like |
| 19:19.52 | starseeker | might want to remove doc/doxygen_output first |
| 19:20.29 | starseeker | I should probably rework the dox target - as matters stand now it's a really mean target |
| 19:21.27 | starseeker | yeah, libdox is way more digestable - that's the one to use |
| 19:21.47 | Notify | 03BRL-CAD:ejno * 63855 (brlcad/trunk/doc/docbook/system/man1/en/g-raw.xml brlcad/trunk/doc/docbook/system/man1/en/g-stl.xml and 2 others): g-stl and g-raw do not actually support specifying the number of cpus; removes the -P option and its documentation |
| 19:22.00 | andromeda-galaxy | starseeker: sounds good, thanks! |
| 19:22.18 | starseeker | you'll need to uncomment your directories of interest |
| 19:22.36 | starseeker | in misc/doxygen/DoxyfileLibs.in |
| 19:24.06 | starseeker | andromeda-galaxy: if you can give me a few minutes, I'll try to rework this so it behaves better out of the box |
| 19:24.18 | starseeker | it looks like I left it in an intermediate state |
| 19:34.37 | *** join/#brlcad ankesh11 (uid8015@gateway/web/irccloud.com/x-snchydpstykpdwrp) |
| 19:42.16 | starseeker | andromeda-galaxy: it's the interrelated nature of the libs that's complicating the output - for per-library activities we need a simple subset target |
| 19:42.28 | starseeker | I think I see where I was heading - let me try to finish it |
| 20:08.26 | andromeda_galaxy | starseeker: great, thanks! (Sorry I couldn't reply earlier, but I had to leave suddenly) |
| 20:08.36 | starseeker | no problem - this is taking a little bit |
| 20:14.23 | *** join/#brlcad jagmeet (~js@202.164.53.117) |
| 20:21.07 | Notify | 02GCI: * : - |
| 20:26.59 | andromeda-galaxy | starseeker: well, thanks for looking into it! I'll start trying to fix some of the warnings that I got from a 'make dox' in the meantime... |
| 20:27.16 | MarcTannous | anyone knows when the next batch of tasks is coming? |
| 20:27.49 | starseeker | MarcTannous: just brlcad ;-) |
| 20:37.17 | andromeda-galaxy | starseeker: for me, 'make dox' doesn't seem to be taking too long.. is that a problem? |
| 20:37.28 | andromeda-galaxy | I'm just runing 'make dox' from in build/ |
| 20:39.44 | Notify | 02GCI:ralpt3748752_qejwhe * 5292150220652544 : All ok - /usr/brlcad/bin/mged |
| 20:42.45 | Notify | 03BRL-CAD:starseeker * 63856 (brlcad/trunk/misc/CMakeLists.txt brlcad/trunk/misc/doxygen/DoxyfileLibs.in brlcad/trunk/misc/doxygen/doxygen_intro.h): Make per-library doxygen targets. |
| 20:45.13 | andromeda-galaxy | starseeker: what did you call the targets? |
| 20:54.54 | Notify | 03BRL-CAD:starseeker * 63857 brlcad/trunk/misc/doxygen/Doxyfile.in: update Doxyfile.in - probably should be autogenerating this input list... |
| 21:02.09 | Notify | 03BRL-CAD:starseeker * 63858 (brlcad/trunk/misc/doxygen/CMakeLists.txt brlcad/trunk/misc/doxygen/Doxyfile.in brlcad/trunk/misc/doxygen/DoxyfileLibs.in): Shorten file names |
| 21:02.13 | andromeda-galaxy | starseeker: for that task, do I need to fix all the "<variable/function/parameter> not document" warnings? |
| 21:05.32 | andromeda-galaxy | starseeker: there are *lots* more warnings with 'make dox-libbu' than with 'make dox'... especially, there are a bunch more member not documented warnings and a bunch linked file is not an input file ones... |
| 21:18.12 | starseeker | andromeda-galaxy: make dox is fine if it's fast enough - I changed the inputs, so it's shorter |
| 21:18.20 | starseeker | that may change in the future though |
| 21:19.00 | starseeker | libbu gets most of the doxygen effort, since it's first in the dependency changes |
| 21:19.04 | starseeker | chains rather |
| 21:20.04 | starseeker | make dox will produce the nice toplevel at the moment, which will be the most useful for determing what things are not organized |
| 21:20.13 | starseeker | if libbu is in good shape, you can move on to libbn |
| 21:21.53 | starseeker | the make dox target is preferable for the reasons you noted - you'll have undefined variables et. al. |
| 21:23.01 | starseeker | I probably need to make the PDF generation depend on a build variable and detecting latex... the html output is useful without the pdf output, and can be generated much faster... |
| 21:27.38 | starseeker | andromeda-galaxy: does the current setup make a little more sense? each lib*.dox file defines the organizational hierarchy that is used in the headers |
| 21:38.17 | Notify | 03BRL-CAD:n_reed * 63859 (brlcad/trunk/src/tclscripts/archer/Archer.tcl brlcad/trunk/src/tclscripts/archer/ArcherCore.tcl): use associative arrays to eliminate duplicated switches |
| 21:48.24 | starseeker | andromeda-galaxy: if you see warnings that look like they're due to missing files that may be me not adding the right directories |
| 21:54.14 | starseeker | needs to hook up n_reed's dom2dox into the doxygen build... |
| 22:08.40 | andromeda-galaxy | starseeker: makes sense... I'll work from 'make dox' for now... try running make dox-libbu on your machine, and you should see what I mean about the extra warnings |
| 22:28.16 | Notify | 02GCI:riyer15 * 6452933096898560 : Claim Removed - The claim on this task has been removed, someone else can claim it now. |
| 22:55.51 | maths22 | andromeda-galaxy, starseeker: have you seen my docbook documentation stuff? |
| 22:59.05 | andromeda-galaxy | maths22: maths22: just looked at it now, looks great! |
| 23:15.57 | andromeda-galaxy | starseeker, maths22: what do the comments next to each constant in include/bu/magic.h mean? |
| 23:26.57 | Notify | 02GCI:zehata * 5032082837340160 : Original files - Due to some errors, I was not able to upload the original files in time before the deadline, could I get an extension for a day or two? Regards, ... |
| 23:32.38 | andromeda-galaxy | doxygen is complaining about messed-up documentation for UNUSED() parameters.... any idea how to fix that? It seems like it would be somewhat complicated since the behavior of UNUSED() is compiler-dependent |