SF.net SVN: openvrml:[3517] branches/0.17

[<br...@us...>]

Revision: 3517
          http://openvrml.svn.sourceforge.net/openvrml/?rev=3517&view=rev
Author:   braden
Date:     2008-08-15 22:51:59 +0000 (Fri, 15 Aug 2008)

Log Message:
-----------
Improved doc-comment.

Modified Paths:
--------------
    branches/0.17/ChangeLog
    branches/0.17/src/libopenvrml/openvrml/browser.cpp

Modified: branches/0.17/ChangeLog
===================================================================
--- branches/0.17/ChangeLog	2008-08-15 22:48:45 UTC (rev 3516)
+++ branches/0.17/ChangeLog	2008-08-15 22:51:59 UTC (rev 3517)
@@ -1,5 +1,11 @@
 2008-08-15 Braden McDaniel  <br...@en...>
 
+	* src/libopenvrml/openvrml/browser.cpp
+	(openvrml::browser::load_url(const std::vector<std::string> &,
+	const std::vector<std::string> &)): Improved doc-comment.
+
+2008-08-15 Braden McDaniel  <br...@en...>
+
 	* src/libopenvrml/openvrml/node.cpp: Symbols with internal linkage
 	don't need visibility attributes.
 

Modified: branches/0.17/src/libopenvrml/openvrml/browser.cpp
===================================================================
--- branches/0.17/src/libopenvrml/openvrml/browser.cpp	2008-08-15 22:48:45 UTC (rev 3516)
+++ branches/0.17/src/libopenvrml/openvrml/browser.cpp	2008-08-15 22:51:59 UTC (rev 3517)
@@ -7996,13 +7996,21 @@
 };
 
 /**
- * @brief Load a VRML world into the browser.
+ * @brief Asynchronously load a VRML world into the @c browser.
  *
+ * This function takes an alternative URI list consistent with such lists as
+ * they appear in VRML nodes.  @c openvrml::browser_event::initialized will be
+ * emitted once the world has been loaded and initialized.
+ *
+ * For synchronously loading a world, see @c #set_world.
+ *
  * @param[in] url       a URI.
  * @param[in] parameter parameters for @p url.
  *
  * @exception std::bad_alloc                if memory allocation fails.
  * @exception boost::thread_resource_error  if thread creation fails.
+ *
+ * @sa #set_world
  */
 void openvrml::browser::load_url(const std::vector<std::string> & url,
                                  const std::vector<std::string> &)


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