From 08d5f114c959876ee2eac2baa2de18a459ef2b6a Mon Sep 17 00:00:00 2001 From: zwelch Date: Sat, 23 May 2009 22:52:47 +0000 Subject: Update main page of doxygen developer documentation: - Rewrite copy to give a better introduction and overview. - Add subpages: The List, Style Guide, Patch Policies, and Bug Reporting. git-svn-id: svn://svn.berlios.de/openocd/trunk@1897 b42882b7-edfa-0310-969c-e2dbd0fdcd60 --- doc/manual/main.txt | 33 +++++++++++++++++++++++++-------- 1 file changed, 25 insertions(+), 8 deletions(-) (limited to 'doc/manual') diff --git a/doc/manual/main.txt b/doc/manual/main.txt index f4111ca4..0a0e43cd 100644 --- a/doc/manual/main.txt +++ b/doc/manual/main.txt @@ -1,14 +1,31 @@ /** @mainpage OpenOCD Reference Manual -@ref oocd explains how the code has been organized into layers -of APIs and gives an overview of how they fit together. These pages -attempt to give developers a high-level perspective of the various -code modules provided by OpenOCD. - -@ref primer provide introductory materials for new developers. +Welcome to the OpenOCD Reference Manual -- the developer's resource for +learning about the internal architecture of the OpenOCD project. -The List of @ref thelist enumerates opportunities for improving or -extending the OpenOCD platform. +In addition, this document contains the tactical and strategic plans +and processes that have been devleoped by and for the community. + +Developers that want to contribute to OpenOCD should read the following +sections before starting work: + +- The List of @subpage thelist enumerates opportunities for improving or +extending the OpenOCD platform. If your ideas are on The List, you might +check the mailing list archives to find the status of your feature (or bug). +- The @subpage styleguide provides rules that developers should + follow when writing new code for OpenOCD. +- The @subpage patchguide provides policies that developers should + follow when submitting patches to the project. +- The @subpage bugs page contains the content of the BUGS file, which + provides instructions for submitting bug reports to the maintainers. + +@ref primer provide introductory materials for new developers on various +specific topics. + +Finally, the @ref oocd pages explain how the code has been organized +into layers of APIs, providing an overview of how they fit together. +These pages attempt to give developers a high-level perspective of the +various code modules provided by OpenOCD. */ -- cgit v1.2.3