[Author Prev][Author Next][Thread Prev][Thread Next][Author Index][Thread Index]
gEDA-cvs: gaf.git: branch: stable-1.8 updated (1.7.2-20111231-65-g6842117)
The branch, stable-1.8 has been updated
via 684211777ffcf0414887f814207da97dc37dd5fa (commit)
via cbdd5af9825c99a38164fdd76f49be6a5e887821 (commit)
via 933fe9c5c4b90998979cd2fafc12625e89c388d9 (commit)
via cff8761501a0215ea2f152497d31760e1842f3d0 (commit)
via 88a3237e51f50d1a4dd7661a4cf3706a2d89475f (commit)
from 72be40e1081e56050a81e73e74c5a4e0c645fe3d (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
=========
Summary
=========
HACKING | 2 +-
gschem/src/g_rc.c | 11 +++++++++--
libgeda/src/g_rc.c | 10 +++++++++-
libgeda/src/s_toplevel.c | 9 +++++++--
4 files changed, 26 insertions(+), 6 deletions(-)
=================
Commit Messages
=================
commit cbdd5af9825c99a38164fdd76f49be6a5e887821
Author: Gareth Edwards <gareth@xxxxxxxxxxxxxxxxxxxx>
Commit: Gareth Edwards <gareth@xxxxxxxxxxxxxxxxxxxx>
gschem: add function documentation for g_rc_gschem_version()
:100644 100644 089f069... b1373a7... M gschem/src/g_rc.c
commit 933fe9c5c4b90998979cd2fafc12625e89c388d9
Author: Gareth Edwards <gareth@xxxxxxxxxxxxxxxxxxxx>
Commit: Gareth Edwards <gareth@xxxxxxxxxxxxxxxxxxxx>
libgeda: Add doxygen definition to s_toplevel_new()
:100644 100644 c891f9d... 1f8684b... M libgeda/src/s_toplevel.c
commit cff8761501a0215ea2f152497d31760e1842f3d0
Author: Gareth Edwards <gareth@xxxxxxxxxxxxxxxxxxxx>
Commit: Gareth Edwards <gareth@xxxxxxxxxxxxxxxxxxxx>
libgeda: Doxygen for g_rc.c.
Add a brief doxygen comment for the g_rc.c file in the header. Also
added explanatory not to bug tag for g_rc_parse().
:100644 100644 06bd810... 32d4eee... M libgeda/src/g_rc.c
commit 88a3237e51f50d1a4dd7661a4cf3706a2d89475f
Author: Gareth Edwards <gareth@xxxxxxxxxxxxxxxxxxxx>
Commit: Gareth Edwards <gareth@xxxxxxxxxxxxxxxxxxxx>
HACKING: Update mailing list URL
:100644 100644 4e7a188... 5020aa1... M HACKING
=========
Changes
=========
commit cbdd5af9825c99a38164fdd76f49be6a5e887821
Author: Gareth Edwards <gareth@xxxxxxxxxxxxxxxxxxxx>
Commit: Gareth Edwards <gareth@xxxxxxxxxxxxxxxxxxxx>
gschem: add function documentation for g_rc_gschem_version()
diff --git a/gschem/src/g_rc.c b/gschem/src/g_rc.c
index 089f069..b1373a7 100644
--- a/gschem/src/g_rc.c
+++ b/gschem/src/g_rc.c
@@ -58,10 +58,17 @@ void g_rc_parse_gtkrc()
g_free (filename);
}
-/*! \todo Finish function documentation!!!
- * \brief
+/*! \brief Verify the version of the RC file under evaluation.
* \par Function Description
*
+ * Implements the Scheme function "gschem-version". Tests the version
+ * string in the argument against the version of the application
+ * itself.
+ *
+ * \param [in] scm_version Scheme object containing RC file version string
+ *
+ * \returns #t if the version of the RC file matches the application,
+ * else #f.
*/
SCM g_rc_gschem_version(SCM scm_version)
{
commit 933fe9c5c4b90998979cd2fafc12625e89c388d9
Author: Gareth Edwards <gareth@xxxxxxxxxxxxxxxxxxxx>
Commit: Gareth Edwards <gareth@xxxxxxxxxxxxxxxxxxxx>
libgeda: Add doxygen definition to s_toplevel_new()
diff --git a/libgeda/src/s_toplevel.c b/libgeda/src/s_toplevel.c
index c891f9d..1f8684b 100644
--- a/libgeda/src/s_toplevel.c
+++ b/libgeda/src/s_toplevel.c
@@ -62,10 +62,15 @@ static void call_new_toplevel_hook (gpointer hook, gpointer toplevel)
h->func (t, h->data);
}
-/*! \todo Finish function documentation!!!
- * \brief
+/*!
+ * \brief Create a TOPLEVEL object
* \par Function Description
+ * Create and return an empty TOPLEVEL object with sensible defaults
+ * for its properties.
+ *
+ * \returns the newly created TOPLEVEL.
*
+ * \todo rethink block below that is set in gschem but used in libgeda.
*/
TOPLEVEL *s_toplevel_new (void)
{
commit cff8761501a0215ea2f152497d31760e1842f3d0
Author: Gareth Edwards <gareth@xxxxxxxxxxxxxxxxxxxx>
Commit: Gareth Edwards <gareth@xxxxxxxxxxxxxxxxxxxx>
libgeda: Doxygen for g_rc.c.
Add a brief doxygen comment for the g_rc.c file in the header. Also
added explanatory not to bug tag for g_rc_parse().
diff --git a/libgeda/src/g_rc.c b/libgeda/src/g_rc.c
index 06bd810..32d4eee 100644
--- a/libgeda/src/g_rc.c
+++ b/libgeda/src/g_rc.c
@@ -17,6 +17,13 @@
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
*/
+/*! \file g_rc.c
+ * \brief Parse configuration files.
+ *
+ * Contains functions to open, parse and manage gEDA configuration
+ * (RC) files.
+ */
+
#include <config.h>
#include <missing.h>
@@ -318,7 +325,8 @@ g_rc_parse__process_error (GError **err, const gchar *pname)
* error other than ENOENT occurs while parsing a configuration file,
* prints an informative message and calls exit(1).
*
- * \bug libgeda shouldn't call exit().
+ * \bug libgeda shouldn't call exit() - this function calls
+ * g_rc_parse__process_error(), which does.
*
* \warning Since this function may not return, it should only be used
* on application startup or when there is no chance of data loss from
commit 88a3237e51f50d1a4dd7661a4cf3706a2d89475f
Author: Gareth Edwards <gareth@xxxxxxxxxxxxxxxxxxxx>
Commit: Gareth Edwards <gareth@xxxxxxxxxxxxxxxxxxxx>
HACKING: Update mailing list URL
diff --git a/HACKING b/HACKING
index 4e7a188..5020aa1 100644
--- a/HACKING
+++ b/HACKING
@@ -72,7 +72,7 @@ you should e-mail the `gEDA-user' mailing list with a reminder.
A final thought: to get your patches included, make it easy to accept
them!
-[1] http://www.seul.org/cgi-bin/mailman/listinfo/geda-user
+[1] http://www.delorie.com/listserv/
[2] http://www.kernel.org/pub/software/scm/git/docs/git-format-patch.html
[3] http://www.stack.nl/~dimitri/doxygen/
_______________________________________________
geda-cvs mailing list
geda-cvs@xxxxxxxxxxxxxx
http://www.seul.org/cgi-bin/mailman/listinfo/geda-cvs