CVS update: gnucash/src/import-export

[Christian Stimming]

-----BEGIN PGP SIGNED MESSAGE-----

Dear Benoit,

wow, I'm glad to see contributions for more importer modules... especially the 
log-replay, which has been asked for for as long as I have been with gnucash 
:-)

On Donnerstag, 29. Mai 2003 06:47, Benoit Gr?goire wrote:
> 	* src/engine/gnc-numeric.h
> 	* src/import-export/import-match-map.c: Doxygen update

I'm a bit confused here... you did a doxygen update *in the .c file*? I 
thought once upon a time the consensus was pretty much to keep the function 
documentation in the .h header file, and only there? In my opinion we should 
really stick to something like that, because the header file is the interface 
that others need to read, and the .c file should really be only the 
implementation which should not be necessary to read at all. Instead, IMHO 
everything you need to know from the outside should be described in the 
header file... If you have different ideas about where to keep the 
documentation, I am open for a discussion here, but I thought this had 
already been discussed earlier.

Christian
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.2-rc1-SuSE (GNU/Linux)

iQCUAwUBPtX00GXAi+BfhivFAQEBuAP3SgtgDKoGtaFV2D3aeoCN/hMQ9c/08kzj
gsKhlBCiQjOtFFIQ98GGV5USNzlOfh8l+3XUB8++vouqFUaWVeU16tFVvCCRXU90
9mpgua6nNdGAxZCyLbc97RFSnA8eYL3XfpzEn0FUXZUFoczqjQ5mRgfamHXZqVkP
e7P9LINWrw==
=nnt+
-----END PGP SIGNATURE-----