From: luzpaz Date: Sat, 8 Nov 2025 09:24:07 +0000 (-0500) Subject: Documentation - Fix whitespaces (#807) X-Git-Url: http://git.dev.opencascade.org/gitweb/?a=commitdiff_plain;h=e52550047003b7c740af5108a14a32185cd4e080;p=occt.git Documentation - Fix whitespaces (#807) - Reformatted multi-line documentation comments to improve readability - Removed trailing whitespace and unnecessary separators - Improved logical grouping of related documentation items --- diff --git a/src/DataExchange/TKXCAF/XCAFDoc/XCAFDoc_ShapeTool.hxx b/src/DataExchange/TKXCAF/XCAFDoc/XCAFDoc_ShapeTool.hxx index 41c6101109..6d3721739a 100644 --- a/src/DataExchange/TKXCAF/XCAFDoc/XCAFDoc_ShapeTool.hxx +++ b/src/DataExchange/TKXCAF/XCAFDoc/XCAFDoc_ShapeTool.hxx @@ -120,7 +120,7 @@ public: //! Returns True if the label is not used by any assembly, i.e. //! contains sublabels which are assembly components //! This is relevant only if IsShape() is True - //! (There is no Father TreeNode on this ) + //! (There is no Father TreeNode on this ) Standard_EXPORT static Standard_Boolean IsFree(const TDF_Label& L); //! Returns True if the label represents a shape (simple shape, diff --git a/src/DataExchange/TKXCAF/XCAFDoc/XCAFDoc_ViewTool.hxx b/src/DataExchange/TKXCAF/XCAFDoc/XCAFDoc_ViewTool.hxx index 610a904e05..b8a8710ee4 100644 --- a/src/DataExchange/TKXCAF/XCAFDoc/XCAFDoc_ViewTool.hxx +++ b/src/DataExchange/TKXCAF/XCAFDoc/XCAFDoc_ViewTool.hxx @@ -77,7 +77,7 @@ public: const TDF_LabelSequence& theGDTs, const TDF_Label& theViewL) const; - //! Set Clipping planes to given View + //! Set Clipping planes to given View Standard_EXPORT void SetClippingPlanes(const TDF_LabelSequence& theClippingPlaneLabels, const TDF_Label& theViewL) const; diff --git a/src/DataExchange/TKXSBase/IFSelect/IFSelect_SessionFile.hxx b/src/DataExchange/TKXSBase/IFSelect/IFSelect_SessionFile.hxx index 6015aac052..707e62d34a 100644 --- a/src/DataExchange/TKXSBase/IFSelect/IFSelect_SessionFile.hxx +++ b/src/DataExchange/TKXSBase/IFSelect/IFSelect_SessionFile.hxx @@ -120,7 +120,7 @@ public: //! Performs a Read Operation from a file to a WorkSession //! i.e. calls ReadFile, then ReadSession and ReadEnd //! Returned Value is : 0 for OK, -1 File could not be opened, - //! >0 Error during Read (see WriteSession) + //! >0 Error during Read (see WriteSession) //! IsDone can be called too (will return True for OK) Standard_EXPORT Standard_Integer Read(const Standard_CString filename); diff --git a/src/DataExchange/TKXSBase/IFSelect/IFSelect_SessionPilot.hxx b/src/DataExchange/TKXSBase/IFSelect/IFSelect_SessionPilot.hxx index 1a13ec2b68..8353df53a2 100644 --- a/src/DataExchange/TKXSBase/IFSelect/IFSelect_SessionPilot.hxx +++ b/src/DataExchange/TKXSBase/IFSelect/IFSelect_SessionPilot.hxx @@ -52,7 +52,7 @@ DEFINE_STANDARD_HANDLE(IFSelect_SessionPilot, IFSelect_Activator) //! -> such a command may be called : //! - directly, it will add an item with no name //! - by command xset, in the following form : -//! xset name command ... calls the command and adds the item +//! xset name command ... calls the command and adds the item //! to the session under the specified name (if not yet known) //! //! Thus, to a specific Norm or way of working, only Activators diff --git a/src/DataExchange/TKXSBase/IFSelect/IFSelect_SignCounter.hxx b/src/DataExchange/TKXSBase/IFSelect/IFSelect_SignCounter.hxx index 9eb1110b1d..2ef928996e 100644 --- a/src/DataExchange/TKXSBase/IFSelect/IFSelect_SignCounter.hxx +++ b/src/DataExchange/TKXSBase/IFSelect/IFSelect_SignCounter.hxx @@ -122,7 +122,8 @@ public: //! Changes the mode of working with the selection : //! -1 just clears optimisation data and nothing else - //! 0 clears it 1 inhibits it for computing (but no clearing) + //! 0 clears it + //! 1 inhibits it for computing (but no clearing) //! 2 sets it active for computing //! Default at creation is 0, after SetSelection (not null) is 2 Standard_EXPORT void SetSelMode(const Standard_Integer selmode); diff --git a/src/DataExchange/TKXSBase/IFSelect/IFSelect_Signature.hxx b/src/DataExchange/TKXSBase/IFSelect/IFSelect_Signature.hxx index 7b6401ab32..192dc8df40 100644 --- a/src/DataExchange/TKXSBase/IFSelect/IFSelect_Signature.hxx +++ b/src/DataExchange/TKXSBase/IFSelect/IFSelect_Signature.hxx @@ -64,7 +64,7 @@ public: //! Returns the predefined list of possible cases, filled by AddCase //! Null Handle if no predefined list (hence, to be counted) - //! Useful to filter on really possible vase, for instance, or + //! Useful to filter on really possible vase, for instance, or //! for a help Standard_EXPORT Handle(TColStd_HSequenceOfAsciiString) CaseList() const; diff --git a/src/DataExchange/TKXSBase/IFSelect/IFSelect_TransformStandard.hxx b/src/DataExchange/TKXSBase/IFSelect/IFSelect_TransformStandard.hxx index 525458a753..e750d49b86 100644 --- a/src/DataExchange/TKXSBase/IFSelect/IFSelect_TransformStandard.hxx +++ b/src/DataExchange/TKXSBase/IFSelect/IFSelect_TransformStandard.hxx @@ -70,7 +70,7 @@ public: Standard_EXPORT IFSelect_TransformStandard(); //! Sets the Copy option to a new value : - //! - True for StandardCopy - False for OnTheSpot + //! True for StandardCopy. False for OnTheSpot Standard_EXPORT void SetCopyOption(const Standard_Boolean option); //! Returns the Copy option diff --git a/src/DataExchange/TKXSBase/Interface/Interface_Category.hxx b/src/DataExchange/TKXSBase/Interface/Interface_Category.hxx index e50d0aee1c..b51ffc6e22 100644 --- a/src/DataExchange/TKXSBase/Interface/Interface_Category.hxx +++ b/src/DataExchange/TKXSBase/Interface/Interface_Category.hxx @@ -42,10 +42,10 @@ class Interface_InterfaceModel; //! Drawing (Drawing, Views, Annotations, Pictures, Sketches ...) //! Structure (Component & Part, Groups & Patterns ...) //! Description (Meta-Data : Relations, Properties, Product ...) -//! Auxiliary (those which do not enter in the above list) +//! Auxiliary (those which do not enter in the above list) //! and some dedicated categories -//! FEA , Kinematics , Piping , etc... -//! plus Professional for other dedicated non-classed categories +//! FEA, Kinematics, Piping, etc... +//! plus Professional for other dedicated non-classed categories //! //! In addition, this class provides a way to compute then quickly //! query category numbers for an entire model. diff --git a/src/DataExchange/TKXSBase/Interface/Interface_CheckIterator.hxx b/src/DataExchange/TKXSBase/Interface/Interface_CheckIterator.hxx index 8bc691f386..c4d2a89185 100644 --- a/src/DataExchange/TKXSBase/Interface/Interface_CheckIterator.hxx +++ b/src/DataExchange/TKXSBase/Interface/Interface_CheckIterator.hxx @@ -111,7 +111,7 @@ public: Standard_EXPORT Interface_CheckStatus Status() const; //! Tells if this check list complies with a given status : - //! OK (i.e. empty), Warning (at least one Warning, but no Fail), + //! OK (i.e. empty), Warning (at least one Warning, but no Fail), //! Fail (at least one), Message (not OK), NoFail, Any Standard_EXPORT Standard_Boolean Complies(const Interface_CheckStatus status) const; diff --git a/src/DataExchange/TKXSBase/Interface/Interface_EntityIterator.hxx b/src/DataExchange/TKXSBase/Interface/Interface_EntityIterator.hxx index 022744eddc..d7663bfb85 100644 --- a/src/DataExchange/TKXSBase/Interface/Interface_EntityIterator.hxx +++ b/src/DataExchange/TKXSBase/Interface/Interface_EntityIterator.hxx @@ -50,7 +50,7 @@ public: //! same as AddItem (kept for compatibility) Standard_EXPORT void GetOneItem(const Handle(Standard_Transient)& anentity); - //! Selects entities with are Kind of a given type, keep only + //! Selects entities with are Kind of a given type, keep only //! them (is keep is True) or reject only them (if keep is False) Standard_EXPORT void SelectType(const Handle(Standard_Type)& atype, const Standard_Boolean keep); diff --git a/src/DataExchange/TKXSBase/Interface/Interface_FloatWriter.hxx b/src/DataExchange/TKXSBase/Interface/Interface_FloatWriter.hxx index aa838b15c9..a041a9ae4c 100644 --- a/src/DataExchange/TKXSBase/Interface/Interface_FloatWriter.hxx +++ b/src/DataExchange/TKXSBase/Interface/Interface_FloatWriter.hxx @@ -36,7 +36,7 @@ class Interface_FloatWriter public: DEFINE_STANDARD_ALLOC - //! Creates a FloatWriter ready to work, with default options - + //! Creates a FloatWriter ready to work, with default options //! - zero suppress option is set //! - main format is set to "%E" //! - secondary format is set to "%f" for values between 0.1 and diff --git a/src/DataExchange/TKXSBase/Interface/Interface_GeneralModule.hxx b/src/DataExchange/TKXSBase/Interface/Interface_GeneralModule.hxx index cda56b11a1..7bb1297eca 100644 --- a/src/DataExchange/TKXSBase/Interface/Interface_GeneralModule.hxx +++ b/src/DataExchange/TKXSBase/Interface/Interface_GeneralModule.hxx @@ -37,7 +37,7 @@ DEFINE_STANDARD_HANDLE(Interface_GeneralModule, Standard_Transient) //! by an Interface) : Shared List, Check, Copy, Delete, Category //! //! To optimise processing (e.g. firstly bind an Entity to a Module -//! then calls Module), each recognized Entity Type corresponds +//! then calls Module), each recognized Entity Type corresponds //! to a Case Number, determined by the Protocol each class of //! GeneralModule belongs to. class Interface_GeneralModule : public Standard_Transient diff --git a/src/DataExchange/TKXSBase/Interface/Interface_Graph.hxx b/src/DataExchange/TKXSBase/Interface/Interface_Graph.hxx index 0adbeab939..633abbf7ec 100644 --- a/src/DataExchange/TKXSBase/Interface/Interface_Graph.hxx +++ b/src/DataExchange/TKXSBase/Interface/Interface_Graph.hxx @@ -123,7 +123,7 @@ public: //! Same as above but directly on an Entity : if it is not //! contained in the Model, returns False. Else calls - //! IsPresent(num) with given by EntityNumber + //! IsPresent(num) with given by EntityNumber Standard_EXPORT Standard_Boolean IsPresent(const Handle(Standard_Transient)& ent) const; //! Returns mapped Entity given its no (if it is present) diff --git a/src/DataExchange/TKXSBase/Interface/Interface_InterfaceModel.hxx b/src/DataExchange/TKXSBase/Interface/Interface_InterfaceModel.hxx index e5ced837a0..eeca095f27 100644 --- a/src/DataExchange/TKXSBase/Interface/Interface_InterfaceModel.hxx +++ b/src/DataExchange/TKXSBase/Interface/Interface_InterfaceModel.hxx @@ -118,9 +118,9 @@ public: //! Returns the Number of an Entity in the Model if it contains it. //! Else returns 0. For a ReportEntity, looks at Concerned Entity. - //! Returns the Directory entry Number of an Entity in - //! the Model if it contains it. Else returns 0. For a - //! ReportEntity, looks at Concerned Entity. + //! Returns the Directory entry Number of an Entity in + //! the Model if it contains it. Else returns 0. + //! For a ReportEntity, looks at Concerned Entity. Standard_EXPORT Standard_Integer Number(const Handle(Standard_Transient)& anentity) const; //! Returns an Entity identified by its number in the Model diff --git a/src/DataExchange/TKXSBase/Interface/Interface_MSG.hxx b/src/DataExchange/TKXSBase/Interface/Interface_MSG.hxx index 8e44e7d63b..9fa16414ab 100644 --- a/src/DataExchange/TKXSBase/Interface/Interface_MSG.hxx +++ b/src/DataExchange/TKXSBase/Interface/Interface_MSG.hxx @@ -52,7 +52,7 @@ public: //! with operator () attached to Value //! Then, to have a translated message, write in C++ : //! - //! Interface_MSG("...mykey...") which returns a CString + //! Interface_MSG("...mykey...") which returns a CString //! See also some help which follow Standard_EXPORT Interface_MSG(const Standard_CString key); @@ -62,14 +62,14 @@ public: //! then AddFail(mess); //! replaced by AddFail (Interface_MSG("code",ival)); //! - //! The basic message is intended to be in C-Sprintf format, + //! The basic message is intended to be in C-Sprintf format, //! with one %d form in it Standard_EXPORT Interface_MSG(const Standard_CString key, const Standard_Integer i1); //! Translates a message which contains two integer variables //! As for one integer, it is just a writing help //! - //! The basic message is intended to be in C-Sprintf format + //! The basic message is intended to be in C-Sprintf format //! with two %d forms in it Standard_EXPORT Interface_MSG(const Standard_CString key, const Standard_Integer i1, @@ -80,7 +80,7 @@ public: //! interval (see below, method Intervals) //! As for one integer, it is just a writing help //! - //! The basic message is intended to be in C-Sprintf format + //! The basic message is intended to be in C-Sprintf format //! with one %f form (or equivalent : %e etc) in it Standard_EXPORT Interface_MSG(const Standard_CString key, const Standard_Real r1, @@ -89,7 +89,7 @@ public: //! Translates a message which contains one string variable //! As for one integer, it is just a writing help //! - //! The basic message is intended to be in C-Sprintf format + //! The basic message is intended to be in C-Sprintf format //! with one %s form in it Standard_EXPORT Interface_MSG(const Standard_CString key, const Standard_CString str); @@ -98,7 +98,7 @@ public: //! As for one integer, it is just a writing help //! Used for instance to say "Param n0. i.e. is not.." //! - //! The basic message is intended to be in C-Sprintf format + //! The basic message is intended to be in C-Sprintf format //! with one %d then one %s forms in it Standard_EXPORT Interface_MSG(const Standard_CString key, const Standard_Integer ival, @@ -184,9 +184,9 @@ public: const Standard_Boolean upper = Standard_False); //! Codes a date as a text, from its numeric value (-> seconds) : - //! YYYY-MM-DD:HH-MN-SS fixed format, completed by leading zeros + //! YYYY-MM-DD:HH-MN-SS fixed format, completed by leading zeros //! Another format can be provided, as follows : - //! C:%d ... C like format, preceded by C: + //! C:%d ... C like format, preceded by C: //! S:... format to call system (not yet implemented) Standard_EXPORT static void TDate(const Standard_CString text, const Standard_Integer yy, diff --git a/src/DataExchange/TKXSBase/Interface/Interface_ParamList.hxx b/src/DataExchange/TKXSBase/Interface/Interface_ParamList.hxx index 73f65d5ad4..aaae4f2f2c 100644 --- a/src/DataExchange/TKXSBase/Interface/Interface_ParamList.hxx +++ b/src/DataExchange/TKXSBase/Interface/Interface_ParamList.hxx @@ -47,7 +47,7 @@ public: //! Assigns the value to the -th item of this array. Standard_EXPORT void SetValue(const Standard_Integer Index, const Interface_FileParameter& Value); - //! Return the value of the th element of the + //! Return the value of the th element of the //! array. Standard_EXPORT const Interface_FileParameter& Value(const Standard_Integer Index) const; @@ -56,7 +56,7 @@ public: return Value(Index); } - //! return the value of the th element of the + //! return the value of the th element of the //! array. Standard_EXPORT Interface_FileParameter& ChangeValue(const Standard_Integer Index); diff --git a/src/DataExchange/TKXSBase/Interface/Interface_Static.hxx b/src/DataExchange/TKXSBase/Interface/Interface_Static.hxx index 772c0795eb..0a46696922 100644 --- a/src/DataExchange/TKXSBase/Interface/Interface_Static.hxx +++ b/src/DataExchange/TKXSBase/Interface/Interface_Static.hxx @@ -83,7 +83,7 @@ public: //! - Name //! - Family, //! - Wildcard (if it has one) - //! - Current status (empty string if it was updated or + //! - Current status (empty string if it was updated or //! if it is the original one) //! - Value Standard_EXPORT void PrintStatic(Standard_OStream& S) const; diff --git a/src/DataExchange/TKXSBase/MoniTool/MoniTool_CaseData.hxx b/src/DataExchange/TKXSBase/MoniTool/MoniTool_CaseData.hxx index d1490249f6..d5ac77f5f7 100644 --- a/src/DataExchange/TKXSBase/MoniTool/MoniTool_CaseData.hxx +++ b/src/DataExchange/TKXSBase/MoniTool/MoniTool_CaseData.hxx @@ -143,7 +143,7 @@ public: const Standard_CString name = ""); //! Adds the CPU time between lastCPU and now - //! if is given, the CPU amount is curCPU-lastCPU + //! if is given, the CPU amount is curCPU-lastCPU //! else it is currently measured CPU - lastCPU //! lastCPU has been read by call to GetCPU //! See GetCPU to get amount, and LargeCPU to test large amount diff --git a/src/DataExchange/TKXSBase/MoniTool/MoniTool_TransientElem.hxx b/src/DataExchange/TKXSBase/MoniTool/MoniTool_TransientElem.hxx index 2d8b2b450c..81ae71a363 100644 --- a/src/DataExchange/TKXSBase/MoniTool/MoniTool_TransientElem.hxx +++ b/src/DataExchange/TKXSBase/MoniTool/MoniTool_TransientElem.hxx @@ -32,7 +32,7 @@ DEFINE_STANDARD_HANDLE(MoniTool_TransientElem, MoniTool_Element) //! //! Transient from Standard defines the class to be keyed //! MapTransientHasher from TColStd is the associated Hasher -//! DataInfo from MoniTool is an additional class which helps to provide +//! DataInfo from MoniTool is an additional class which helps to provide //! information on the value (template : see DataInfo) class MoniTool_TransientElem : public MoniTool_Element { diff --git a/src/DataExchange/TKXSBase/MoniTool/MoniTool_TypedValue.hxx b/src/DataExchange/TKXSBase/MoniTool/MoniTool_TypedValue.hxx index 9e9894bcf8..6311ee3800 100644 --- a/src/DataExchange/TKXSBase/MoniTool/MoniTool_TypedValue.hxx +++ b/src/DataExchange/TKXSBase/MoniTool/MoniTool_TypedValue.hxx @@ -151,7 +151,7 @@ public: //! For an enumeration, precises the starting value (default 0) //! and the match condition : if True (D), the string value must //! match the definition, else it may take another value : in that - //! case, the Integer Value will be Start - 1. + //! case, the Integer Value will be Start - 1. //! (empty value remains allowed) Standard_EXPORT void StartEnum(const Standard_Integer start = 0, const Standard_Boolean match = Standard_True); diff --git a/src/DataExchange/TKXSBase/Transfer/Transfer_FindHasher.hxx b/src/DataExchange/TKXSBase/Transfer/Transfer_FindHasher.hxx index dae6196adb..5c038619a7 100644 --- a/src/DataExchange/TKXSBase/Transfer/Transfer_FindHasher.hxx +++ b/src/DataExchange/TKXSBase/Transfer/Transfer_FindHasher.hxx @@ -23,7 +23,7 @@ #include //! FindHasher defines HashCode for Finder, which is : ask a -//! Finder its HashCode ! Because this is the Finder itself which +//! Finder its HashCode! Because this is the Finder itself which //! brings the HashCode for its Key //! //! This class complies to the template given in TCollection by diff --git a/src/DataExchange/TKXSBase/XSControl/XSControl_Controller.hxx b/src/DataExchange/TKXSBase/XSControl/XSControl_Controller.hxx index 6d93ba12dc..589377891e 100644 --- a/src/DataExchange/TKXSBase/XSControl/XSControl_Controller.hxx +++ b/src/DataExchange/TKXSBase/XSControl/XSControl_Controller.hxx @@ -98,7 +98,7 @@ public: // szv:{ return mySignType; } //! Returns the WorkLibrary attached to the Norm. Remark that it - //! has to be in phase with the Protocol (read from field) + //! has to be in phase with the Protocol (read from field) const Handle(IFSelect_WorkLibrary)& WorkLibrary() const { return myAdaptorLibrary; } //! Creates a new empty Model ready to receive data of the Norm @@ -220,7 +220,7 @@ public: protected: //! Initializing with names - //! is for the complete, official, long name + //! is for the complete, official, long name //! is for the short name used for resources Standard_EXPORT XSControl_Controller(const Standard_CString theLongName, const Standard_CString theShortName); diff --git a/src/DataExchange/TKXSBase/XSControl/XSControl_WorkSession.hxx b/src/DataExchange/TKXSBase/XSControl/XSControl_WorkSession.hxx index a992d784d4..42b8a0416c 100644 --- a/src/DataExchange/TKXSBase/XSControl/XSControl_WorkSession.hxx +++ b/src/DataExchange/TKXSBase/XSControl/XSControl_WorkSession.hxx @@ -100,7 +100,8 @@ public: Standard_OStream& theS) const; //! Sets a Transfer Reader, by internal ways, according mode : - //! 0 recreates it clear, 1 clears it (does not recreate) + //! 0 recreates it clear + //! 1 clears it (does not recreate) //! 2 aligns Roots of TransientProcess from final Results //! 3 aligns final Results from Roots of TransientProcess //! 4 begins a new transfer (by BeginTransfer) diff --git a/src/DataExchange/TKXmlXCAF/XmlXCAFDrivers/XmlXCAFDrivers.hxx b/src/DataExchange/TKXmlXCAF/XmlXCAFDrivers/XmlXCAFDrivers.hxx index 08bea15d96..a6f13a3fa3 100644 --- a/src/DataExchange/TKXmlXCAF/XmlXCAFDrivers/XmlXCAFDrivers.hxx +++ b/src/DataExchange/TKXmlXCAF/XmlXCAFDrivers/XmlXCAFDrivers.hxx @@ -25,7 +25,7 @@ class TDocStd_Application; class XmlXCAFDrivers { public: - //! Depending from the ID, returns a list of storage + //! Depending from the ID, returns a list of storage //! or retrieval attribute drivers. Used for plugin. //! //! Standard data model drivers diff --git a/src/DataExchange/TKXmlXCAF/XmlXCAFDrivers/XmlXCAFDrivers_DocumentStorageDriver.hxx b/src/DataExchange/TKXmlXCAF/XmlXCAFDrivers/XmlXCAFDrivers_DocumentStorageDriver.hxx index 84169e99e1..8ef1bc08e6 100644 --- a/src/DataExchange/TKXmlXCAF/XmlXCAFDrivers/XmlXCAFDrivers_DocumentStorageDriver.hxx +++ b/src/DataExchange/TKXmlXCAF/XmlXCAFDrivers/XmlXCAFDrivers_DocumentStorageDriver.hxx @@ -27,7 +27,7 @@ class Message_Messenger; class XmlXCAFDrivers_DocumentStorageDriver; DEFINE_STANDARD_HANDLE(XmlXCAFDrivers_DocumentStorageDriver, XmlDrivers_DocumentStorageDriver) -//! storage driver of a XS document +//! storage driver of a XS document class XmlXCAFDrivers_DocumentStorageDriver : public XmlDrivers_DocumentStorageDriver { diff --git a/src/Draw/TKDCAF/DDF/DDF.hxx b/src/Draw/TKDCAF/DDF/DDF.hxx index c4af0fb892..bb37aa7988 100644 --- a/src/Draw/TKDCAF/DDF/DDF.hxx +++ b/src/Draw/TKDCAF/DDF/DDF.hxx @@ -34,15 +34,15 @@ class DDF public: DEFINE_STANDARD_ALLOC - //! Search in draw directory the framewok identified + //! Search in draw directory the framewok identified //! by its name . returns True if found. In that //! case is set. Standard_EXPORT static Standard_Boolean GetDF(Standard_CString& Name, Handle(TDF_Data)& DF, const Standard_Boolean Complain = Standard_True); - //! Search in the label identified by its entry - //! . returns if found. In that case + //! Search in the label identified by its entry + //! . returns if found. In that case //!