/************************************************************************* * * OpenOffice.org - a multi-platform office productivity suite * * $RCSfile: hfi_doc.cxx,v $ * * $Revision: 1.8 $ * * last change: $Author: vg $ $Date: 2007-09-18 13:56:02 $ * * The Contents of this file are made available subject to * the terms of GNU Lesser General Public License Version 2.1. * * * GNU Lesser General Public License Version 2.1 * ============================================= * Copyright 2005 by Sun Microsystems, Inc. * 901 San Antonio Road, Palo Alto, CA 94303, USA * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License version 2.1, as published by the Free Software Foundation. * * This library 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 59 Temple Place, Suite 330, Boston, * MA 02111-1307 USA * ************************************************************************/ #include #include "hfi_doc.hxx" // NOT FULLY DEFINED SERVICES #include #include #include #include #include "hfi_tag.hxx" HF_IdlDocu::HF_IdlDocu( Environment & io_rEnv, HF_DocEntryList & o_rOut ) : HtmlFactory_Idl( io_rEnv, &o_rOut.CurOut() ), rOut(o_rOut) { } HF_IdlDocu::~HF_IdlDocu() { } // KORR // Should not be used any longer. // Use Produce_byCesOwnDocu() or Produce_byDocu4Reference() // instead. void HF_IdlDocu::Produce_byData( const client & i_ce, const ce_info * i_doc ) const { const ce_info * i_pDocu = i_doc != 0 ? i_doc : i_ce.Docu(); if (i_pDocu == 0) return; bool bShort = NOT i_pDocu->Short().IsEmpty(); bool bDescr = NOT i_pDocu->Description().IsEmpty(); if ( i_pDocu->IsDeprecated() AND i_ce.SightLevel() != ary::idl::sl_File OR i_pDocu->IsOptional() ) { rOut.Produce_Term("Usage Restrictions"); if ( i_pDocu->IsDeprecated() ) rOut.Produce_Definition() >> *new Html::Italic << "deprecated"; if ( i_pDocu->IsOptional() ) rOut.Produce_Definition() >> *new Html::Italic << "optional"; } if ( i_pDocu->IsDeprecated() AND // KORR // Workaround, because DocuTex2::IsEmpty() does not // calculate whitespace tokens only as empty. i_pDocu->DeprecatedText().Tokens().size() > 1 ) { rOut.Produce_Term("Deprecation Info"); HF_IdlDocuTextDisplay aDescription( Env(), 0, i_ce); aDescription.Out().Enter( rOut.Produce_Definition() ); i_pDocu->DeprecatedText().DisplayAt( aDescription ); aDescription.Out().Leave(); } if ( bShort OR bDescr ) { rOut.Produce_Term("Description"); HF_IdlDocuTextDisplay aDescription( Env(), 0, i_ce); if (bShort) { aDescription.Out().Enter( rOut.Produce_Definition() ); i_pDocu->Short().DisplayAt( aDescription ); aDescription.Out().Leave(); } if (bDescr) { aDescription.Out().Enter( rOut.Produce_Definition() ); i_pDocu->Description().DisplayAt( aDescription ); aDescription.Out().Leave(); } } std::vector< csi::dsapi::DT_SeeAlsoAtTag* > aSeeAlsosWithoutText; std::vector< csi::dsapi::DT_SeeAlsoAtTag* > aSeeAlsosWithText; for ( std::vector< ary::info::AtTag2* >::const_iterator iter = i_pDocu->Tags().begin(); iter != i_pDocu->Tags().end(); ++iter ) { if ( strlen( (*iter)->Title() ) > 0 ) { csi::dsapi::DT_SeeAlsoAtTag* pSeeAlso = dynamic_cast< csi::dsapi::DT_SeeAlsoAtTag * >(*iter); if (pSeeAlso != 0 ) { if ( pSeeAlso->Text().IsEmpty() ) { aSeeAlsosWithoutText.push_back(pSeeAlso); } else { aSeeAlsosWithText.push_back(pSeeAlso); } continue; } HF_IdlTag aTag(Env(), i_ce); Xml::Element & rTerm = rOut.Produce_Term(); aTag.Produce_byData( rTerm, rOut.Produce_Definition(), *(*iter) ); } } // end for if (aSeeAlsosWithoutText.size() > 0) { HF_IdlTag aSeeAlsoTag(Env(), i_ce); Xml::Element & rTerm = rOut.Produce_Term(); aSeeAlsoTag.Produce_byData( rTerm, rOut.Produce_Definition(), aSeeAlsosWithoutText ); } for ( std::vector< csi::dsapi::DT_SeeAlsoAtTag* >::const_iterator itSee2 = aSeeAlsosWithText.begin(); itSee2 != aSeeAlsosWithText.end(); ++itSee2 ) { HF_IdlTag aTag(Env(), i_ce); Xml::Element & rTerm = rOut.Produce_Term(); aTag.Produce_byData( rTerm, rOut.Produce_Definition(), *(*itSee2) ); } // end for } void HF_IdlDocu::Produce_byCesOwnDocu( const client & i_ce ) const { const ce_info * i_pDocu = i_ce.Docu(); if (i_pDocu != 0) Produce_byDocuAndScope(*i_pDocu, &i_ce, i_ce); } void HF_IdlDocu::Produce_byDocu4Reference( const ce_info & i_rDocuForReference, const client & i_rScopeGivingCe ) const { Produce_byDocuAndScope(i_rDocuForReference, 0, i_rScopeGivingCe); } void HF_IdlDocu::Produce_byDocuAndScope( const ce_info & i_rDocu, const client * i_pClient, const client & i_rScopeGivingCe ) const { bool bShort = NOT i_rDocu.Short().IsEmpty(); bool bDescr = NOT i_rDocu.Description().IsEmpty(); if ( i_rDocu.IsDeprecated() OR (i_pClient != 0 ? i_pClient->SightLevel() == ary::idl::sl_File : false) AND NOT i_rDocu.IsPublished() OR i_rDocu.IsOptional() ) { // any usage restriction rOut.Produce_Term("Usage Restrictions"); if ( i_rDocu.IsDeprecated() ) rOut.Produce_Definition() >> *new Html::Italic << "deprecated"; if ( (i_pClient != 0 ? i_pClient->SightLevel() == ary::idl::sl_File : false) AND NOT i_rDocu.IsPublished() ) rOut.Produce_Definition() >> *new Html::Italic << "not published"; if ( i_rDocu.IsOptional() ) rOut.Produce_Definition() >> *new Html::Italic << "optional"; if ( i_rDocu.IsDeprecated() AND // KORR // Workaround, because DocuTex2::IsEmpty() does not // calculate whitespace tokens only as empty. i_rDocu.DeprecatedText().Tokens().size() > 1 ) { rOut.Produce_Term("Deprecation Info"); HF_IdlDocuTextDisplay aDescription( Env(), 0, i_rScopeGivingCe); aDescription.Out().Enter( rOut.Produce_Definition() ); i_rDocu.DeprecatedText().DisplayAt( aDescription ); aDescription.Out().Leave(); } } // end if () if ( bShort OR bDescr ) { rOut.Produce_Term("Description"); HF_IdlDocuTextDisplay aDescription( Env(), 0, i_rScopeGivingCe); if (bShort) { aDescription.Out().Enter( rOut.Produce_Definition() ); i_rDocu.Short().DisplayAt( aDescription ); aDescription.Out().Leave(); } if (bDescr) { aDescription.Out().Enter( rOut.Produce_Definition() ); i_rDocu.Description().DisplayAt( aDescription ); aDescription.Out().Leave(); } } for ( std::vector< ary::info::AtTag2* >::const_iterator iter = i_rDocu.Tags().begin(); iter != i_rDocu.Tags().end(); ++iter ) { if ( strlen( (*iter)->Title() ) > 0 ) { HF_IdlTag aTag(Env(), i_rScopeGivingCe); Xml::Element & rTerm = rOut.Produce_Term(); aTag.Produce_byData( rTerm, rOut.Produce_Definition(), *(*iter) ); } } // end for }