12 Mar
2016
12 Mar
'16
4:12 p.m.
Hi, it's Germano from Ninux.org community.
For personal purposes, I am commenting vis.c/vis.h alfred code, at the
beginning of each function, explaining also most important local
variables (keeping in mind documentation guidelines [1])
I would like to know if you are interested in such documentation
process. If yes, I could extend this kind of work to the whole alfred
code.
Have a nice day
[1]: https://www.kernel.org/doc/Documentation/kernel-doc-nano-HOWTO.txt
12 Mar
12 Mar
5:55 p.m.
On Saturday 12 March 2016 17:12:19 Germano Massullo wrote:
Hi, it's Germano from Ninux.org community.
For personal purposes, I am commenting vis.c/vis.h alfred code, at the
beginning of each function, explaining also most important local
variables (keeping in mind documentation guidelines [1])
I would like to know if you are interested in such documentation
process. If yes, I could extend this kind of work to the whole alfred
code.
Sounds great. I am currently not sure about the "explaining also most
important local variables" part but maybe you just do the vis.c/.h and then
submit it as patch(es) [1]. This way we can discuss it on an actual example
before you crawl through the complete alfred(-vis|-gpsd) codebase.
Kind regards,
Sven
[1] https://www.open-mesh.org/projects/open-mesh/wiki/Contribute#Submitting-pat…
14 Mar
14 Mar
9:50 p.m.
Il 12/03/2016 18:55, Sven Eckelmann ha scritto:
I am currently not sure about the "explaining
also most important
local variables"
For example in the function
=========
static int vis_read_answer(struct globals *globals)
{
const struct vis_print_ops *ops;
struct vis_v1 *vis_data;
uint16_t len;
struct vis_iface *ifaces;
struct vis_entry *vis_entries;
// CUT
=========
I would stress the purposes description of
struct vis_v1 *vis_data
struct vis_iface *ifaces
struct vis_entry *vis_entries
30 Sep
30 Sep
5:38 a.m.
Hi, I want to tell that I have not forgotten the task, but I have been
very busy during past months :-)
I think to resume the work in autumn :-)
2374
days inactive
2576
days old
b.a.t.m.a.n@lists.open-mesh.org
3 comments
2 participants
participants (2)
-
Germano Massullo -
Sven Eckelmann