Revision: 50719
          http://brlcad.svn.sourceforge.net/brlcad/?rev=50719&view=rev
Author:   tbrowder2
Date:     2012-05-27 20:30:54 +0000 (Sun, 27 May 2012)
Log Message:
-----------
add target specifications for bu_vls_vprintf

Modified Paths:
--------------
    brlcad/trunk/src/libbu/vls_vprintf.c

Modified: brlcad/trunk/src/libbu/vls_vprintf.c
===================================================================
--- brlcad/trunk/src/libbu/vls_vprintf.c        2012-05-27 20:09:58 UTC (rev 
50718)
+++ brlcad/trunk/src/libbu/vls_vprintf.c        2012-05-27 20:30:54 UTC (rev 
50719)
@@ -181,6 +181,35 @@
 }
 #endif
 
+/*
+
+The bu_vls_vprintf function aims to adhere to the following
+specifications:
+
+  1.  First, follow the UNIX man page at
+      "http://www.unix.com/man-page/POSIX/3/printf/"; regarding the
+      definition of a format specifier.
+
+  2.  Then modify [1] to accomodate a compatible subset of parts
+      applicable to a wide range of standard C libraries including
+      GNU/Linux, Windows, FreeBSD, and others as differences are
+      brought to our attention.
+
+  3.  The subset [2] shall be the "valid" flags, length modifers, and
+      conversion specifiers ("parts") accepted by this function.
+
+  4.  Parts known to be defined outside subset [3] shall generate a
+      message stating such invalidity and giving a suitable
+      alternative if possible (such parts will be called "obsolete");
+      otherwise, the part shall be said to be "unsupported."  Any part
+      of either category will then generate a bu_bomb.
+
+  5.  Parts seen by this function but not defined above shall be
+      deemed "unknown" and result in a suitable message followed by a
+      bu_bomb.
+
+*/
+
 void
 bu_vls_vprintf(struct bu_vls *vls, const char *fmt, va_list ap)
 {

This was sent by the SourceForge.net collaborative development platform, the 
world's largest Open Source development site.


------------------------------------------------------------------------------
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 Source Commits mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/brlcad-commits

Reply via email to