1*b1cdbd2cSJim Jagielski /**************************************************************
2*b1cdbd2cSJim Jagielski *
3*b1cdbd2cSJim Jagielski * Licensed to the Apache Software Foundation (ASF) under one
4*b1cdbd2cSJim Jagielski * or more contributor license agreements. See the NOTICE file
5*b1cdbd2cSJim Jagielski * distributed with this work for additional information
6*b1cdbd2cSJim Jagielski * regarding copyright ownership. The ASF licenses this file
7*b1cdbd2cSJim Jagielski * to you under the Apache License, Version 2.0 (the
8*b1cdbd2cSJim Jagielski * "License"); you may not use this file except in compliance
9*b1cdbd2cSJim Jagielski * with the License. You may obtain a copy of the License at
10*b1cdbd2cSJim Jagielski *
11*b1cdbd2cSJim Jagielski * http://www.apache.org/licenses/LICENSE-2.0
12*b1cdbd2cSJim Jagielski *
13*b1cdbd2cSJim Jagielski * Unless required by applicable law or agreed to in writing,
14*b1cdbd2cSJim Jagielski * software distributed under the License is distributed on an
15*b1cdbd2cSJim Jagielski * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
16*b1cdbd2cSJim Jagielski * KIND, either express or implied. See the License for the
17*b1cdbd2cSJim Jagielski * specific language governing permissions and limitations
18*b1cdbd2cSJim Jagielski * under the License.
19*b1cdbd2cSJim Jagielski *
20*b1cdbd2cSJim Jagielski *************************************************************/
21*b1cdbd2cSJim Jagielski
22*b1cdbd2cSJim Jagielski #include <precomp.h>
23*b1cdbd2cSJim Jagielski #include "hfi_doc.hxx"
24*b1cdbd2cSJim Jagielski
25*b1cdbd2cSJim Jagielski
26*b1cdbd2cSJim Jagielski // NOT FULLY DEFINED SERVICES
27*b1cdbd2cSJim Jagielski #include <ary/idl/i_ce.hxx>
28*b1cdbd2cSJim Jagielski #include <ary/doc/d_oldidldocu.hxx>
29*b1cdbd2cSJim Jagielski #include <ary_i/d_token.hxx>
30*b1cdbd2cSJim Jagielski #include <toolkit/hf_docentry.hxx>
31*b1cdbd2cSJim Jagielski #include "hfi_tag.hxx"
32*b1cdbd2cSJim Jagielski #include "hi_ary.hxx"
33*b1cdbd2cSJim Jagielski
34*b1cdbd2cSJim Jagielski
35*b1cdbd2cSJim Jagielski
36*b1cdbd2cSJim Jagielski
HF_IdlDocu(Environment & io_rEnv,HF_DocEntryList & o_rOut)37*b1cdbd2cSJim Jagielski HF_IdlDocu::HF_IdlDocu( Environment & io_rEnv,
38*b1cdbd2cSJim Jagielski HF_DocEntryList & o_rOut )
39*b1cdbd2cSJim Jagielski : HtmlFactory_Idl( io_rEnv, &o_rOut.CurOut() ),
40*b1cdbd2cSJim Jagielski rOut(o_rOut)
41*b1cdbd2cSJim Jagielski {
42*b1cdbd2cSJim Jagielski }
43*b1cdbd2cSJim Jagielski
~HF_IdlDocu()44*b1cdbd2cSJim Jagielski HF_IdlDocu::~HF_IdlDocu()
45*b1cdbd2cSJim Jagielski {
46*b1cdbd2cSJim Jagielski }
47*b1cdbd2cSJim Jagielski
48*b1cdbd2cSJim Jagielski void
Produce_fromCodeEntity(const client & i_ce) const49*b1cdbd2cSJim Jagielski HF_IdlDocu::Produce_fromCodeEntity( const client & i_ce ) const
50*b1cdbd2cSJim Jagielski {
51*b1cdbd2cSJim Jagielski const ce_info *
52*b1cdbd2cSJim Jagielski i_pDocu = Get_IdlDocu(i_ce.Docu());
53*b1cdbd2cSJim Jagielski if (i_pDocu != 0)
54*b1cdbd2cSJim Jagielski Produce_byDocuAndScope(*i_pDocu, &i_ce, i_ce);
55*b1cdbd2cSJim Jagielski }
56*b1cdbd2cSJim Jagielski
57*b1cdbd2cSJim Jagielski void
Produce_fromReference(const ce_info & i_rDocuForReference,const client & i_rScopeGivingCe) const58*b1cdbd2cSJim Jagielski HF_IdlDocu::Produce_fromReference( const ce_info & i_rDocuForReference,
59*b1cdbd2cSJim Jagielski const client & i_rScopeGivingCe ) const
60*b1cdbd2cSJim Jagielski {
61*b1cdbd2cSJim Jagielski Produce_byDocuAndScope(i_rDocuForReference, 0, i_rScopeGivingCe );
62*b1cdbd2cSJim Jagielski }
63*b1cdbd2cSJim Jagielski
64*b1cdbd2cSJim Jagielski void
Produce_byDocuAndScope(const ce_info & i_rDocu,const client * i_pClient,const client & i_rScopeGivingCe) const65*b1cdbd2cSJim Jagielski HF_IdlDocu::Produce_byDocuAndScope( const ce_info & i_rDocu,
66*b1cdbd2cSJim Jagielski const client * i_pClient,
67*b1cdbd2cSJim Jagielski const client & i_rScopeGivingCe ) const
68*b1cdbd2cSJim Jagielski {
69*b1cdbd2cSJim Jagielski bool bShort = NOT i_rDocu.Short().IsEmpty();
70*b1cdbd2cSJim Jagielski bool bDescr = NOT i_rDocu.Description().IsEmpty();
71*b1cdbd2cSJim Jagielski
72*b1cdbd2cSJim Jagielski if ( i_rDocu.IsDeprecated()
73*b1cdbd2cSJim Jagielski OR (
74*b1cdbd2cSJim Jagielski (i_pClient != 0 ? i_pClient->SightLevel() == ary::idl::sl_File : false)
75*b1cdbd2cSJim Jagielski AND NOT i_rDocu.IsPublished()
76*b1cdbd2cSJim Jagielski )
77*b1cdbd2cSJim Jagielski OR i_rDocu.IsOptional() )
78*b1cdbd2cSJim Jagielski { // any usage restriction
79*b1cdbd2cSJim Jagielski rOut.Produce_Term("Usage Restrictions");
80*b1cdbd2cSJim Jagielski
81*b1cdbd2cSJim Jagielski if ( i_rDocu.IsDeprecated() )
82*b1cdbd2cSJim Jagielski rOut.Produce_Definition() >> *new Html::Italic << "deprecated";
83*b1cdbd2cSJim Jagielski if ( (i_pClient != 0 ? i_pClient->SightLevel() == ary::idl::sl_File : false)
84*b1cdbd2cSJim Jagielski AND NOT i_rDocu.IsPublished() )
85*b1cdbd2cSJim Jagielski rOut.Produce_Definition() >> *new Html::Italic << "not published";
86*b1cdbd2cSJim Jagielski if ( i_rDocu.IsOptional() )
87*b1cdbd2cSJim Jagielski rOut.Produce_Definition() >> *new Html::Italic << "optional";
88*b1cdbd2cSJim Jagielski
89*b1cdbd2cSJim Jagielski if ( i_rDocu.IsDeprecated() AND
90*b1cdbd2cSJim Jagielski // KORR_FUTURE
91*b1cdbd2cSJim Jagielski // Workaround, because DocuTex2::IsEmpty() does not
92*b1cdbd2cSJim Jagielski // calculate whitespace tokens only as empty.
93*b1cdbd2cSJim Jagielski i_rDocu.DeprecatedText().Tokens().size() > 1 )
94*b1cdbd2cSJim Jagielski {
95*b1cdbd2cSJim Jagielski rOut.Produce_Term("Deprecation Info");
96*b1cdbd2cSJim Jagielski
97*b1cdbd2cSJim Jagielski HF_IdlDocuTextDisplay
98*b1cdbd2cSJim Jagielski aDescription( Env(), 0, i_rScopeGivingCe);
99*b1cdbd2cSJim Jagielski aDescription.Out().Enter( rOut.Produce_Definition() );
100*b1cdbd2cSJim Jagielski i_rDocu.DeprecatedText().DisplayAt( aDescription );
101*b1cdbd2cSJim Jagielski aDescription.Out().Leave();
102*b1cdbd2cSJim Jagielski }
103*b1cdbd2cSJim Jagielski } // end if (<any usage restriction>)
104*b1cdbd2cSJim Jagielski
105*b1cdbd2cSJim Jagielski if ( bShort OR bDescr )
106*b1cdbd2cSJim Jagielski {
107*b1cdbd2cSJim Jagielski rOut.Produce_Term("Description");
108*b1cdbd2cSJim Jagielski HF_IdlDocuTextDisplay
109*b1cdbd2cSJim Jagielski aDescription( Env(), 0, i_rScopeGivingCe);
110*b1cdbd2cSJim Jagielski if (bShort)
111*b1cdbd2cSJim Jagielski {
112*b1cdbd2cSJim Jagielski aDescription.Out().Enter( rOut.Produce_Definition() );
113*b1cdbd2cSJim Jagielski i_rDocu.Short().DisplayAt( aDescription );
114*b1cdbd2cSJim Jagielski aDescription.Out().Leave();
115*b1cdbd2cSJim Jagielski }
116*b1cdbd2cSJim Jagielski if (bDescr)
117*b1cdbd2cSJim Jagielski {
118*b1cdbd2cSJim Jagielski aDescription.Out().Enter( rOut.Produce_Definition() );
119*b1cdbd2cSJim Jagielski i_rDocu.Description().DisplayAt( aDescription );
120*b1cdbd2cSJim Jagielski aDescription.Out().Leave();
121*b1cdbd2cSJim Jagielski }
122*b1cdbd2cSJim Jagielski }
123*b1cdbd2cSJim Jagielski
124*b1cdbd2cSJim Jagielski std::vector< csi::dsapi::DT_SeeAlsoAtTag* >
125*b1cdbd2cSJim Jagielski aSeeAlsosWithoutText;
126*b1cdbd2cSJim Jagielski std::vector< csi::dsapi::DT_SeeAlsoAtTag* >
127*b1cdbd2cSJim Jagielski aSeeAlsosWithText;
128*b1cdbd2cSJim Jagielski
129*b1cdbd2cSJim Jagielski for ( std::vector< ary::inf::AtTag2* >::const_iterator
130*b1cdbd2cSJim Jagielski iter = i_rDocu.Tags().begin();
131*b1cdbd2cSJim Jagielski iter != i_rDocu.Tags().end();
132*b1cdbd2cSJim Jagielski ++iter )
133*b1cdbd2cSJim Jagielski {
134*b1cdbd2cSJim Jagielski csi::dsapi::DT_SeeAlsoAtTag*
135*b1cdbd2cSJim Jagielski pSeeAlso = dynamic_cast< csi::dsapi::DT_SeeAlsoAtTag * >(*iter);
136*b1cdbd2cSJim Jagielski if (pSeeAlso != 0 )
137*b1cdbd2cSJim Jagielski {
138*b1cdbd2cSJim Jagielski if ( pSeeAlso->Text().IsEmpty() )
139*b1cdbd2cSJim Jagielski {
140*b1cdbd2cSJim Jagielski aSeeAlsosWithoutText.push_back(pSeeAlso);
141*b1cdbd2cSJim Jagielski }
142*b1cdbd2cSJim Jagielski else
143*b1cdbd2cSJim Jagielski {
144*b1cdbd2cSJim Jagielski aSeeAlsosWithText.push_back(pSeeAlso);
145*b1cdbd2cSJim Jagielski }
146*b1cdbd2cSJim Jagielski continue;
147*b1cdbd2cSJim Jagielski }
148*b1cdbd2cSJim Jagielski
149*b1cdbd2cSJim Jagielski if ( strlen( (*iter)->Title() ) > 0 )
150*b1cdbd2cSJim Jagielski {
151*b1cdbd2cSJim Jagielski HF_IdlTag
152*b1cdbd2cSJim Jagielski aTag(Env(), i_rScopeGivingCe);
153*b1cdbd2cSJim Jagielski Xml::Element &
154*b1cdbd2cSJim Jagielski rTerm = rOut.Produce_Term();
155*b1cdbd2cSJim Jagielski aTag.Produce_byData( rTerm,
156*b1cdbd2cSJim Jagielski rOut.Produce_Definition(),
157*b1cdbd2cSJim Jagielski *(*iter) );
158*b1cdbd2cSJim Jagielski }
159*b1cdbd2cSJim Jagielski } // end for
160*b1cdbd2cSJim Jagielski
161*b1cdbd2cSJim Jagielski if (aSeeAlsosWithoutText.size() > 0)
162*b1cdbd2cSJim Jagielski {
163*b1cdbd2cSJim Jagielski HF_IdlTag
164*b1cdbd2cSJim Jagielski aSeeAlsoTag(Env(), i_rScopeGivingCe);
165*b1cdbd2cSJim Jagielski Xml::Element &
166*b1cdbd2cSJim Jagielski rTerm = rOut.Produce_Term();
167*b1cdbd2cSJim Jagielski aSeeAlsoTag.Produce_byData( rTerm,
168*b1cdbd2cSJim Jagielski rOut.Produce_Definition(),
169*b1cdbd2cSJim Jagielski aSeeAlsosWithoutText );
170*b1cdbd2cSJim Jagielski }
171*b1cdbd2cSJim Jagielski
172*b1cdbd2cSJim Jagielski for ( std::vector< csi::dsapi::DT_SeeAlsoAtTag* >::const_iterator
173*b1cdbd2cSJim Jagielski itSee2 = aSeeAlsosWithText.begin();
174*b1cdbd2cSJim Jagielski itSee2 != aSeeAlsosWithText.end();
175*b1cdbd2cSJim Jagielski ++itSee2 )
176*b1cdbd2cSJim Jagielski {
177*b1cdbd2cSJim Jagielski HF_IdlTag
178*b1cdbd2cSJim Jagielski aTag(Env(), i_rScopeGivingCe);
179*b1cdbd2cSJim Jagielski Xml::Element &
180*b1cdbd2cSJim Jagielski rTerm = rOut.Produce_Term();
181*b1cdbd2cSJim Jagielski aTag.Produce_byData( rTerm,
182*b1cdbd2cSJim Jagielski rOut.Produce_Definition(),
183*b1cdbd2cSJim Jagielski *(*itSee2) );
184*b1cdbd2cSJim Jagielski } // end for
185*b1cdbd2cSJim Jagielski }
186