Difference between revisions of "OpenEMR API"

From OpenEMR Project Wiki
Line 6: Line 6:
:*(Was completed with phpDocumentor using following command on ubuntu: ''sudo phpdoc -t apidocs -o HTML:default:default -d . --ignore apidocs/,gacl/,phpmyadmin/,library/adodb/,interface/main/calendar/pnadodb/ --defaultpackagename OpenEMR --title "OpenEMR API Documentation" --sourcecode'')
:*(Was completed with phpDocumentor using following command on ubuntu: ''sudo phpdoc -t apidocs -o HTML:default:default -d . --ignore apidocs/,gacl/,phpmyadmin/,library/adodb/,interface/main/calendar/pnadodb/ --defaultpackagename OpenEMR --title "OpenEMR API Documentation" --sourcecode'')
::*Next run:
::*Next run:
:::*Try to fix following parameter: ''--sourcecode'' (considered an unstable option and doesn't appear to be working)
:::*Try to fix following parameter: ''--sourcecode'' (considered an unstable option and doesn't appear to be working) to get it to link to the source code (or figure out another mechanism)
:::*Experiment with other template (such as ''HTML:frames:earthli'')
:::*Experiment with other template (such as ''HTML:frames:earthli'')
:::*See if can category to work (looks like only supported in xml/docBook templates???)


== Plan ==
== Plan ==

Revision as of 00:29, 21 June 2012

Overview

This is a project that was recently started to auto-document the OpenEMR codebase. The project is still in an early phase.

API

  • (Was completed with phpDocumentor using following command on ubuntu: sudo phpdoc -t apidocs -o HTML:default:default -d . --ignore apidocs/,gacl/,phpmyadmin/,library/adodb/,interface/main/calendar/pnadodb/ --defaultpackagename OpenEMR --title "OpenEMR API Documentation" --sourcecode)
  • Next run:
  • Try to fix following parameter: --sourcecode (considered an unstable option and doesn't appear to be working) to get it to link to the source code (or figure out another mechanism)
  • Experiment with other template (such as HTML:frames:earthli)

Plan

  • Directories/Files to ignore:
  • apidocs/
  • Reason - This is the API docs directory
  • gacl/
  • Reason - This is an embedded module with an API already included. Additionally, connector functions can be found at library/acl.inc .
  • phpmyadmin/
  • Reason - This is an embedded application that does not communicate directly with OpenEMR.
  • library/adodb/
  • Reason - This is an embedded module and connector functions can be found at library/sql.inc
  • interface/main/calendar/pnadodb/
  • Reason - This is an embedded module and connector functions can be found at library/sql.inc