xref: /AOO41X/main/autodoc/inc/ary/doc/d_oldcppdocu.hxx (revision 1c78a5d6c0093dece4c096ba53051800fbad6e33)
1 /**************************************************************
2  *
3  * Licensed to the Apache Software Foundation (ASF) under one
4  * or more contributor license agreements.  See the NOTICE file
5  * distributed with this work for additional information
6  * regarding copyright ownership.  The ASF licenses this file
7  * to you under the Apache License, Version 2.0 (the
8  * "License"); you may not use this file except in compliance
9  * with the License.  You may obtain a copy of the License at
10  *
11  *   http://www.apache.org/licenses/LICENSE-2.0
12  *
13  * Unless required by applicable law or agreed to in writing,
14  * software distributed under the License is distributed on an
15  * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
16  * KIND, either express or implied.  See the License for the
17  * specific language governing permissions and limitations
18  * under the License.
19  *
20  *************************************************************/
21 
22 
23 
24 #ifndef ARY_DOC_D_OLDCPPDOCU_HXX
25 #define ARY_DOC_D_OLDCPPDOCU_HXX
26 //  KORR_DEPRECATED_3.0
27 
28 // BASE CLASSES
29 #include <ary/doc/d_node.hxx>
30 // USED SERVICES
31 #include <ary/info/inftypes.hxx>
32 #include <ary/ary_disp.hxx>
33 
34 namespace ary
35 {
36 namespace info
37 {
38     class AtTag;
39     class DocuStore;
40 }
41 }
42 
43 
44 
45 
46 namespace ary
47 {
48 namespace doc
49 {
50     using ::ary::info::AtTag;
51     using ::ary::info::E_AtTagId;
52 
53 
54 /** Wrapper class for old C++ documentation format.
55 
56     To be replaced by using the standard format.
57 */
58 class OldCppDocu : public Node
59 {
60   public:
61     typedef std::vector< DYN AtTag * >  TagList;
62 
63     // LIFECYCLE
64                         OldCppDocu();
65     virtual             ~OldCppDocu();
66 
67     void                Store2(
68                             info::DocuStore &   o_rDocuStore );
69 
70     virtual AtTag *     Create_StdTag(
71                             E_AtTagId           i_eId );
72     virtual AtTag *     CheckIn_BaseTag();
73     virtual AtTag *     CheckIn_ExceptionTag();
74     virtual AtTag *     Create_ImplementsTag();
75     virtual AtTag *     Create_KeywordTag();
76     virtual AtTag *     CheckIn_ParameterTag();
77     virtual AtTag *     CheckIn_SeeTag();
78     virtual AtTag *     CheckIn_TemplateTag();
79     virtual AtTag *     Create_LabelTag();
80     virtual AtTag *     Create_DefaultTag();
81     virtual AtTag *     Create_SinceTag();          /// @return always the first one created.
82 
83     virtual void        Replace_AtShort_By_AtDescr();
84 
85     virtual void        Set_Obsolete();
86     virtual void        Set_Internal();
Set_Interface()87     virtual void        Set_Interface()         { bIsInterface = true; }
88 
89   // INQUIRY
Tags() const90     const TagList &     Tags() const            { return aTags; }
91     const AtTag &       Short() const;
IsObsolete() const92     bool                IsObsolete() const      { return bIsObsolete; }
93     virtual bool        IsInternal() const;
94     virtual bool        IsInterface() const;
95 
96   private:
97     // Interface csv::ConstProcessorClient:
98     virtual void        do_Accept(
99                             csv::ProcessorIfc & io_processor ) const;
100     // DATA
101     unsigned char       nTags[ary::info::C_eAtTag_NrOfClasses];
102 
103     /** Creates a new AtTag at the end of aTags.
104         The index of this new AtTag is inserted in nTags at position
105         i_nIndex.
106     */
107     AtTag * &           NewTag(
108                             UINT8               i_nIndex );
109     /** Returns the Tag with the position nTags[i_nIndex]
110         in aTags.
111     */
112     AtTag &             GetTag(
113                             UINT8               i_nIndex );
114 
115     TagList             aTags;
116     bool                bIsObsolete;
117     bool                bIsInternal;
118     bool                bIsInterface;
119 };
120 
121 
122 
123 
124 }   // namespace doc
125 }   // namespace ary
126 #endif
127