Revert "doxygen tweaks - not complete yet"

This reverts commit b86c313aa2.
ugfx_release_2.6
Joel Bodenmann 2012-11-07 01:34:39 +01:00
parent b86c313aa2
commit a178db6f13
6 changed files with 23 additions and 62 deletions

View File

@ -19,11 +19,10 @@
*/
/**
* @file drivers/touchpad/ADS7843/touchpad_lld.c
* @file drivers/touchpad/XPT2046/touchpad_lld.c
* @brief Touchpad Driver subsystem low level driver source.
*
* @defgroup ADS7843
* @ingroup DRIVERS
* @addtogroup TOUCHPAD
* @{
*/
@ -86,6 +85,7 @@ void tp_lld_init(const TOUCHPADDriver *tp) {
* @param[in] cmd The command bits to send to the touchpad
*
* @return The read value 12-bit right-justified
*
* @note This function only reads data, it is assumed that the pins are
* configured properly and the bus has been acquired beforehand
*
@ -107,6 +107,7 @@ uint16_t tp_lld_read_value(uint8_t cmd) {
/**
* @brief 7-point median filtering code for touchpad samples
*
* @note This is an internally used routine only.
*
* @notapi
@ -128,10 +129,9 @@ static void tp_lld_filter(void) {
}
/**
* @brief Reads out the X value.
* @note The samples are median filtered for greater noise reduction
* @brief Reads out the X direction.
*
* @return The uncalibrated but filtered X value
* @note The samples are median filtered for greater noise reduction
*
* @notapi
*/
@ -170,11 +170,8 @@ uint16_t tp_lld_read_x(void) {
return sampleBuf[3];
}
/**
* @brief Reads out the Y value.
* @note The samples are median filtered for greater noise reduction
*
* @return The uncalibrated but filtered Y value
/*
* @brief Reads out the Y direction.
*
* @notapi
*/
@ -215,8 +212,8 @@ uint16_t tp_lld_read_y(void) {
/* ---- Optional Routines ---- */
#if TOUCHPAD_HAS_IRQ || defined(__DOXYGEN__)
/**
* @brief For checking if touchpad is pressed or not.
/*
* @brief for checking if touchpad is pressed or not.
*
* @return 1 if pressed / 0 if not pressed
*
@ -228,11 +225,9 @@ uint16_t tp_lld_read_y(void) {
#endif
#if TOUCHPAD_HAS_PRESSURE || defined(__DOXYGEN__)
/**
/*
* @brief Reads out the Z direction / pressure.
*
* @return The amount of preasure
*
* @notapi
*/
uint16_t tp_lld_read_z(void) {

View File

@ -22,8 +22,7 @@
* @file drivers/touchpad/ADS7843/touchpad_lld_config.h
* @brief Touchpad Driver subsystem low level driver.
*
* @defgroup ADS7843
* @ingroup DRIVERS
* @addtogroup TOUCHPAD
* @{
*/

View File

@ -22,8 +22,7 @@
* @file drivers/touchpad/XPT2046/touchpad_lld.c
* @brief Touchpad Driver subsystem low level driver source.
*
* @defgroup XPT2046
* @ingroup DRIVERS
* @addtogroup TOUCHPAD
* @{
*/
@ -108,7 +107,8 @@ uint16_t tp_lld_read_value(uint8_t cmd) {
/**
* @brief 7-point median filtering code for touchpad samples
* @note This is an internally used routine only
*
* @note This is an internally used routine only.
*
* @notapi
*/
@ -129,10 +129,9 @@ static void tp_lld_filter(void) {
}
/**
* @brief Reads out the X value.
* @note The samples are median filtered for greater noise reduction
* @brief Reads out the X direction.
*
* @return The uncalibrated but filtered X value
* @note The samples are median filtered for greater noise reduction
*
* @notapi
*/
@ -171,11 +170,8 @@ uint16_t tp_lld_read_x(void) {
return sampleBuf[3];
}
/**
* @brief Reads out the Y value.
* @note The samples are median filtered for greated noise reduction
*
* @return The uncalibrated but filtered Y value
/*
* @brief Reads out the Y direction.
*
* @notapi
*/
@ -216,7 +212,7 @@ uint16_t tp_lld_read_y(void) {
/* ---- Optional Routines ---- */
#if TOUCHPAD_HAS_IRQ || defined(__DOXYGEN__)
/**
/*
* @brief for checking if touchpad is pressed or not.
*
* @return 1 if pressed / 0 if not pressed
@ -229,11 +225,9 @@ uint16_t tp_lld_read_y(void) {
#endif
#if TOUCHPAD_HAS_PRESSURE || defined(__DOXYGEN__)
/**
/*
* @brief Reads out the Z direction / pressure.
*
* @return The mount of preasure
*
* @notapi
*/
uint16_t tp_lld_read_z(void) {

View File

@ -22,8 +22,7 @@
* @file drivers/touchpad/XPT2046/touchpad_lld_config.h
* @brief Touchppad Driver subsystem low level driver.
*
* @defgroup XPT2046
* @ingroup DRIVERS
* @addtogroup TOUCHPAD
* @{
*/

View File

@ -1,25 +0,0 @@
/*
ChibiOS/GFX - Copyright (C) 2012
Joel Bodenmann aka Tectu <joel@unormal.org>
This file is part of ChibiOS/GFX.
ChibiOS/GFX 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 3 of the License, or
(at your option) any later version.
ChibiOS/GFX is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
/**
* @addtogroup DRIVERS
* @{
*/

View File

@ -22,8 +22,7 @@
* @file templates/touchpadXXX/touchpad_lld.c
* @brief Touchpad Driver subsystem low level driver source.
*
* @defgroup touchpadXXX
* @ingroup DRIVERS
* @addtogroup TOUCHPAD
* @{
*/