1 |
commit: fd5fae5995f7ff66358268bb0dd15a072f4a6f57 |
2 |
Author: Mu Qiao <qiaomuf <AT> gentoo <DOT> org> |
3 |
AuthorDate: Thu Aug 4 07:58:16 2011 +0000 |
4 |
Commit: Petteri Räty <betelgeuse <AT> gentoo <DOT> org> |
5 |
CommitDate: Thu Aug 4 14:15:15 2011 +0000 |
6 |
URL: http://git.overlays.gentoo.org/gitweb/?p=proj/libbash.git;a=commit;h=fd5fae59 |
7 |
|
8 |
Doc: reduce doxygen warnings |
9 |
|
10 |
--- |
11 |
src/core/bash_ast.h | 1 + |
12 |
src/core/interpreter.h | 13 +++++++------ |
13 |
src/core/symbols.hpp | 2 +- |
14 |
3 files changed, 9 insertions(+), 7 deletions(-) |
15 |
|
16 |
diff --git a/src/core/bash_ast.h b/src/core/bash_ast.h |
17 |
index dd85ae8..50ca7a6 100644 |
18 |
--- a/src/core/bash_ast.h |
19 |
+++ b/src/core/bash_ast.h |
20 |
@@ -117,6 +117,7 @@ public: |
21 |
|
22 |
/// \brief the functor for parser builtin_variable_definitions rule |
23 |
/// \param parser the pointer to the parser |
24 |
+ /// \param local whether to define the variables in local scope |
25 |
static pANTLR3_BASE_TREE parser_builtin_variable_definitions(libbashParser_Ctx_struct* parser, bool local); |
26 |
|
27 |
/// |
28 |
|
29 |
diff --git a/src/core/interpreter.h b/src/core/interpreter.h |
30 |
index 091d4b7..fcc3294 100644 |
31 |
--- a/src/core/interpreter.h |
32 |
+++ b/src/core/interpreter.h |
33 |
@@ -76,8 +76,8 @@ class interpreter: public boost::noncopyable |
34 |
|
35 |
/// \brief calculate the correct offset when offset < 0 and check whether |
36 |
/// the real offset is in legal range |
37 |
- /// \param[in,out] a value/result argument referring to offset |
38 |
- /// \param[in] the original string |
39 |
+ /// \param[in,out] offset a value/result argument referring to offset |
40 |
+ /// \param[in] size the size of the original string |
41 |
/// \return whether the real offset is in legal range |
42 |
bool get_real_offset(long long& offset, const unsigned size) const |
43 |
{ |
44 |
@@ -368,6 +368,7 @@ public: |
45 |
} |
46 |
|
47 |
/// \brief perform ${parameter:−word} expansion |
48 |
+ /// \param cond whether to perform expansion |
49 |
/// \param name the name of the parameter |
50 |
/// \param value the value of the word |
51 |
/// \param index the index of the paramter |
52 |
@@ -381,6 +382,7 @@ public: |
53 |
} |
54 |
|
55 |
/// \brief perform ${parameter:=word} expansion |
56 |
+ /// \param cond whether to perform expansion |
57 |
/// \param name the name of the parameter |
58 |
/// \param value the value of the word |
59 |
/// \param index the index of the paramter |
60 |
@@ -394,9 +396,8 @@ public: |
61 |
} |
62 |
|
63 |
/// \brief perform ${parameter:+word} expansion |
64 |
- /// \param name the name of the parameter |
65 |
+ /// \param cond whether to perform expansion |
66 |
/// \param value the value of the word |
67 |
- /// \param index the index of the paramter |
68 |
/// \return the expansion result |
69 |
const std::string do_alternate_expansion(bool cond, |
70 |
const std::string& value) const |
71 |
@@ -472,7 +473,7 @@ public: |
72 |
|
73 |
/// \brief implementation of word splitting |
74 |
/// \param word the value of the word |
75 |
- //. \param[out] output the splitted result will be appended to output |
76 |
+ ///.\param[out] output the splitted result will be appended to output |
77 |
void split_word(const std::string& word, std::vector<std::string>& output) const; |
78 |
|
79 |
/// \brief get the status of shell optional behavior |
80 |
@@ -507,7 +508,7 @@ public: |
81 |
long eval_arithmetic(const std::string& expression); |
82 |
|
83 |
/// \brief shift the positional parameters to the left by n. |
84 |
- /// \param the number to be shifted |
85 |
+ /// \param shift_number the number to be shifted |
86 |
/// \return zero unless n is greater than $# or less than zero, non-zero otherwise. |
87 |
int shift(int shift_number); |
88 |
|
89 |
|
90 |
diff --git a/src/core/symbols.hpp b/src/core/symbols.hpp |
91 |
index 15a3fa0..8dd8cd3 100644 |
92 |
--- a/src/core/symbols.hpp |
93 |
+++ b/src/core/symbols.hpp |
94 |
@@ -267,7 +267,7 @@ public: |
95 |
|
96 |
/// \brief the specialized constructor for arrays |
97 |
/// \param name the variable name |
98 |
-/// \param value the variable value |
99 |
+/// \param v the variable value |
100 |
/// \param ro whether the variable readonly |
101 |
template <> |
102 |
inline variable::variable<>(const std::string& name, |