TheCloud/panda3d
1
0
Fork 0
mirror of https://github.com/panda3d/panda3d.git synced 2025-09-30 00:32:57 -04:00
Code Issues Packages Projects Releases Wiki Activity

general: fix some old-style docstring comment blocks

Browse Source
This commit is contained in:
rdb 2018-12-23 16:27:08 +01:00
parent 729a2364bc
commit b40ecd6c51
2 changed files with 24 additions and 34 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

47
panda/src/dxml/config_dxml.cxx
View File

@ -30,14 +30,12 @@ ConfigureFn(config_dxml) {
init_libdxml(); init_libdxml();
} }
//////////////////////////////////////////////////////////////////// /**
// Function: init_libdxml * Initializes the library. This must be called at least once before any of
// Description: Initializes the library. This must be called at * the functions or classes in this library can be used. Normally it will be
// least once before any of the functions or classes in * called by the static initializers and need not be called explicitly, but
// this library can be used. Normally it will be * special cases exist.
// called by the static initializers and need not be */
// called explicitly, but special cases exist.
////////////////////////////////////////////////////////////////////
void void
init_libdxml() { init_libdxml() {
static bool initialized = false; static bool initialized = false;
@ -48,11 +46,10 @@ init_libdxml() {
} }
BEGIN_PUBLISH BEGIN_PUBLISH
//////////////////////////////////////////////////////////////////// /**
// Function: read_xml_stream * Reads an XML document from the indicated stream.
// Description: Reads an XML document from the indicated stream. * @returns the document, or NULL on error.
// Returns the document, or NULL on error. */
////////////////////////////////////////////////////////////////////
TiXmlDocument * TiXmlDocument *
read_xml_stream(std::istream &in) { read_xml_stream(std::istream &in) {
TiXmlDocument *doc = new TiXmlDocument; TiXmlDocument *doc = new TiXmlDocument;
@ -67,10 +64,9 @@ read_xml_stream(std::istream &in) {
END_PUBLISH END_PUBLISH
BEGIN_PUBLISH BEGIN_PUBLISH
//////////////////////////////////////////////////////////////////// /**
// Function: write_xml_stream * Writes an XML document to the indicated stream.
// Description: Writes an XML document to the indicated stream. */
////////////////////////////////////////////////////////////////////
void void
write_xml_stream(std::ostream &out, TiXmlDocument *doc) { write_xml_stream(std::ostream &out, TiXmlDocument *doc) {
out << *doc; out << *doc;
@ -78,10 +74,9 @@ write_xml_stream(std::ostream &out, TiXmlDocument *doc) {
END_PUBLISH END_PUBLISH
BEGIN_PUBLISH BEGIN_PUBLISH
//////////////////////////////////////////////////////////////////// /**
// Function: print_xml * Writes an XML object to stdout, with formatting.
// Description: Writes an XML object to stdout, with formatting. */
////////////////////////////////////////////////////////////////////
void void
print_xml(TiXmlNode *xnode) { print_xml(TiXmlNode *xnode) {
xnode->Print(stdout, 0); xnode->Print(stdout, 0);
@ -89,12 +84,10 @@ print_xml(TiXmlNode *xnode) {
END_PUBLISH END_PUBLISH
BEGIN_PUBLISH BEGIN_PUBLISH
//////////////////////////////////////////////////////////////////// /**
// Function: print_xml_to_file * Writes an XML object to the indicated file, with formatting. Unfortunately
// Description: Writes an XML object to the indicated file, with * the VFS cannot be supported; the file must be a real filename on disk.
// formatting. Unfortunately the VFS cannot be */
// supported; the file must be a real filename on disk.
////////////////////////////////////////////////////////////////////
void void
print_xml_to_file(const Filename &filename, TiXmlNode *xnode) { print_xml_to_file(const Filename &filename, TiXmlNode *xnode) {
std::string os_name = filename.to_os_specific(); std::string os_name = filename.to_os_specific();

11
panda/src/pgraph/camera.cxx
View File

@ -280,13 +280,10 @@ write_datagram(BamWriter *manager, Datagram &dg) {
} }
} }
//////////////////////////////////////////////////////////////////// /**
// Function: Camera::complete_pointers * Receives an array of pointers, one for each time manager->read_pointer()
// Access: Public, Virtual * was called in fillin(). Returns the number of pointers processed.
// Description: Receives an array of pointers, one for each time */
// manager->read_pointer() was called in fillin().
// Returns the number of pointers processed.
////////////////////////////////////////////////////////////////////
int Camera:: int Camera::
complete_pointers(TypedWritable **p_list, BamReader *manager) { complete_pointers(TypedWritable **p_list, BamReader *manager) {
int pi = LensNode::complete_pointers(p_list, manager); int pi = LensNode::complete_pointers(p_list, manager);