From 45f8ae031f06efba856fca5343d0ec3456bd9ccc Mon Sep 17 00:00:00 2001
From: Julia Longtin <julialongtin@diasp.org>
Date: Fri, 8 Feb 2013 06:29:46 +0000
Subject: [PATCH] Start adding documentation to initial comment block, fix up
 some quoting, and add a docblock for getPnoteById.

---
 library/pnotes.inc | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/library/pnotes.inc b/library/pnotes.inc
index 3d55b4aff..20e1b8e8f 100644
--- a/library/pnotes.inc
+++ b/library/pnotes.inc
@@ -1,18 +1,26 @@
 <?php
 /**
+ * This file contains functions for handling notes attached to patient files. 
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU General Public License
  * as published by the Free Software Foundation; either version 2
  * of the License, or (at your option) any later version.
  */
 
-require_once("{$GLOBALS['srcdir']}/sql.inc");
+require_once($GLOBALS['srcdir'].'/sql.inc');
 
+/**
+ * Retrieve a note, given its ID
+ *
+ * @param string $id the ID of the note to retrieve.
+ * @param string $cols A list of columns to retrieve. defaults to '*' for all.
+ */
 function getPnoteById($id, $cols = "*")
 {
   return sqlQuery("SELECT $cols FROM pnotes WHERE id=? " .
-    " AND deleted != 1 ". // exclude ALL deleted notes
-    "order by date DESC limit 0,1", array($id) );
+    ' AND deleted != 1 '. // exclude ALL deleted notes
+    'order by date DESC limit 0,1', array($id) );
 }
 
 // activity can be 0, 1, or 'all'
-- 
2.11.4.GIT