From 6a3c2b124cc890d65f9a5c48241cb34364e4f2e7 Mon Sep 17 00:00:00 2001 From: Oleg Subbotin Date: Tue, 16 Jul 2024 14:51:25 -0400 Subject: [PATCH] Cleanup bal (#4832) --- groups/bal/balber/balber_berconstants.cpp | 8 ---- groups/bal/balber/balber_berconstants.h | 12 ++---- groups/bal/balber/balber_berconstants.t.cpp | 12 +----- groups/bal/balber/balber_berdecoder.cpp | 8 ---- groups/bal/balber/balber_berdecoder.h | 15 ++----- groups/bal/balber/balber_berdecoder.t.cpp | 35 ++++++--------- .../bal/balber/balber_berdecoderoptions.cpp | 23 ++++------ groups/bal/balber/balber_berdecoderoptions.h | 12 +----- .../bal/balber/balber_berdecoderoptions.t.cpp | 8 ---- groups/bal/balber/balber_berencoder.cpp | 9 +--- groups/bal/balber/balber_berencoder.h | 17 ++------ groups/bal/balber/balber_berencoder.t.cpp | 8 ---- .../bal/balber/balber_berencoderoptions.t.cpp | 8 ---- .../balber/balber_beruniversaltagnumber.cpp | 8 ---- .../bal/balber/balber_beruniversaltagnumber.h | 16 ++----- .../balber/balber_beruniversaltagnumber.t.cpp | 13 +----- groups/bal/balber/balber_berutil.cpp | 23 ++-------- groups/bal/balber/balber_berutil.t.cpp | 43 +++++++------------ groups/bal/balscm/balscm_version.t.cpp | 16 ++----- groups/bal/balscm/balscm_versiontag.cpp | 8 ---- groups/bal/balscm/balscm_versiontag.h | 12 ++---- groups/bal/balscm/balscm_versiontag.t.cpp | 16 ++----- groups/bal/balst/balst_assertionlogger.cpp | 8 ---- groups/bal/balst/balst_assertionlogger.h | 8 ---- groups/bal/balst/balst_assertionlogger.t.cpp | 14 ++---- groups/bal/balst/balst_objectfileformat.cpp | 8 ---- groups/bal/balst/balst_objectfileformat.h | 10 +---- groups/bal/balst/balst_objectfileformat.t.cpp | 12 +----- .../bal/balst/balst_resolver_filehelper.cpp | 8 ---- groups/bal/balst/balst_resolver_filehelper.h | 18 +++----- .../bal/balst/balst_resolver_filehelper.t.cpp | 11 +---- .../bal/balst/balst_resolverimpl_dladdr.cpp | 12 +----- groups/bal/balst/balst_resolverimpl_dladdr.h | 8 ---- .../bal/balst/balst_resolverimpl_dladdr.t.cpp | 11 +---- groups/bal/balst/balst_resolverimpl_elf.cpp | 8 ---- groups/bal/balst/balst_resolverimpl_elf.h | 8 ---- groups/bal/balst/balst_resolverimpl_elf.t.cpp | 11 +---- .../bal/balst/balst_resolverimpl_windows.cpp | 8 ---- groups/bal/balst/balst_resolverimpl_windows.h | 8 ---- .../balst/balst_resolverimpl_windows.t.cpp | 8 ---- groups/bal/balst/balst_resolverimpl_xcoff.cpp | 18 +++----- groups/bal/balst/balst_resolverimpl_xcoff.h | 22 +++------- .../bal/balst/balst_resolverimpl_xcoff.t.cpp | 8 ---- groups/bal/balst/balst_stacktrace.cpp | 8 ---- groups/bal/balst/balst_stacktrace.h | 10 +---- groups/bal/balst/balst_stacktrace.t.cpp | 8 ---- groups/bal/balst/balst_stacktraceframe.cpp | 8 ---- groups/bal/balst/balst_stacktraceframe.h | 17 +++----- groups/bal/balst/balst_stacktraceframe.t.cpp | 11 +---- .../bal/balst/balst_stacktraceprintutil.cpp | 8 ---- groups/bal/balst/balst_stacktraceprintutil.h | 8 ---- .../bal/balst/balst_stacktraceprintutil.t.cpp | 15 ++----- .../balst/balst_stacktracetestallocator.cpp | 13 ++---- .../bal/balst/balst_stacktracetestallocator.h | 12 ++---- .../balst/balst_stacktracetestallocator.t.cpp | 23 +++------- groups/bal/balst/balst_stacktraceutil.cpp | 9 +--- groups/bal/balst/balst_stacktraceutil.h | 17 +++----- groups/bal/balst/balst_stacktraceutil.t.cpp | 11 +---- 58 files changed, 136 insertions(+), 599 deletions(-) diff --git a/groups/bal/balber/balber_berconstants.cpp b/groups/bal/balber/balber_berconstants.cpp index 12347ad5c2..e78bf4609b 100644 --- a/groups/bal/balber/balber_berconstants.cpp +++ b/groups/bal/balber/balber_berconstants.cpp @@ -1,12 +1,4 @@ // balber_berconstants.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include #include diff --git a/groups/bal/balber/balber_berconstants.h b/groups/bal/balber/balber_berconstants.h index 2696ad3be3..77f24d0997 100644 --- a/groups/bal/balber/balber_berconstants.h +++ b/groups/bal/balber/balber_berconstants.h @@ -1,12 +1,4 @@ // balber_berconstants.h -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #ifndef INCLUDED_BALBER_BERCONSTANTS #define INCLUDED_BALBER_BERCONSTANTS @@ -27,6 +19,10 @@ BSLS_IDENT("$Id: $") // ///Usage ///----- +// This section illustrates intended use of this component. +// +///Example 1: Basic Usage +/// - - - - - - - - - - - // TBD #include diff --git a/groups/bal/balber/balber_berconstants.t.cpp b/groups/bal/balber/balber_berconstants.t.cpp index f393364497..bec117689d 100644 --- a/groups/bal/balber/balber_berconstants.t.cpp +++ b/groups/bal/balber/balber_berconstants.t.cpp @@ -1,13 +1,4 @@ // balber_berconstants.t.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - - #include #include @@ -23,8 +14,7 @@ using namespace bsl; // TEST PLAN // ---------------------------------------------------------------------------- // -// - +// TBD // ---------------------------------------------------------------------------- // ============================================================================ diff --git a/groups/bal/balber/balber_berdecoder.cpp b/groups/bal/balber/balber_berdecoder.cpp index a522bd6e49..396b575580 100644 --- a/groups/bal/balber/balber_berdecoder.cpp +++ b/groups/bal/balber/balber_berdecoder.cpp @@ -1,12 +1,4 @@ // balber_berdecoder.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include #include diff --git a/groups/bal/balber/balber_berdecoder.h b/groups/bal/balber/balber_berdecoder.h index 0136cdefa3..f1ee825f73 100644 --- a/groups/bal/balber/balber_berdecoder.h +++ b/groups/bal/balber/balber_berdecoder.h @@ -1,12 +1,4 @@ // balber_berdecoder.h -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #ifndef INCLUDED_BALBER_BERDECODER #define INCLUDED_BALBER_BERDECODER @@ -105,14 +97,12 @@ BSLS_IDENT("$Id: $") #include #include -#include - -#include - #include #include +#include + #include #include #include @@ -120,6 +110,7 @@ BSLS_IDENT("$Id: $") #include #include +#include #include namespace BloombergLP { diff --git a/groups/bal/balber/balber_berdecoder.t.cpp b/groups/bal/balber/balber_berdecoder.t.cpp index f7e68614b5..a5c73654e4 100644 --- a/groups/bal/balber/balber_berdecoder.t.cpp +++ b/groups/bal/balber/balber_berdecoder.t.cpp @@ -1,12 +1,4 @@ // balber_berdecoder.t.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include #include // for testing only @@ -39,32 +31,29 @@ #include // for testing only #include // for testing only +#include +#include +#include + +#include +#include +#include +#include + #include #include #include #include #include +#include +#include #include #include #include #include -#include -#include -#include -#include - -#include -#include -#include - -#include - -#include -#include - #include #include #include @@ -73,7 +62,7 @@ #include using namespace BloombergLP; -using namespace bsl; // automatically added by script +using namespace bsl; namespace test = BloombergLP::s_baltst; // ============================================================================ diff --git a/groups/bal/balber/balber_berdecoderoptions.cpp b/groups/bal/balber/balber_berdecoderoptions.cpp index 6d97a21b4b..02708bff9b 100644 --- a/groups/bal/balber/balber_berdecoderoptions.cpp +++ b/groups/bal/balber/balber_berdecoderoptions.cpp @@ -1,12 +1,4 @@ // balber_berdecoderoptions.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include #include @@ -14,14 +6,15 @@ BSLS_IDENT_RCSID(balber_berdecoderoptions_cpp,"$Id$ $CSID$") #include -#include #include #include #include #include -#include +#include + #include +#include namespace BloombergLP { @@ -45,28 +38,28 @@ const bdlat_AttributeInfo balber::BerDecoderOptions::ATTRIBUTE_INFO_ARRAY[] = { "MaxDepth", // name sizeof("MaxDepth") - 1, // name length "maximum recursion depth", // annotation - bdlat_FormattingMode::e_DEC // formatting mode + bdlat_FormattingMode::e_DEC // formatting mode }, { e_ATTRIBUTE_ID_SKIP_UNKNOWN_ELEMENTS, "SkipUnknownElements", // name sizeof("SkipUnknownElements") - 1, // name length "Option to skip unknown elements", // annotation - bdlat_FormattingMode::e_TEXT // formatting mode + bdlat_FormattingMode::e_TEXT // formatting mode }, { e_ATTRIBUTE_ID_TRACE_LEVEL, "TraceLevel", // name sizeof("TraceLevel") - 1, // name length "trace (verbosity) level", // annotation - bdlat_FormattingMode::e_DEC // formatting mode + bdlat_FormattingMode::e_DEC // formatting mode }, { e_ATTRIBUTE_ID_MAX_SEQUENCE_SIZE, "MaxSequenceSize", // name sizeof("MaxSequenceSize") - 1, // name length "maximum sequence size", // annotation - bdlat_FormattingMode::e_DEC // formatting mode + bdlat_FormattingMode::e_DEC // formatting mode }, { e_ATTRIBUTE_ID_DEFAULT_EMPTY_STRINGS, @@ -74,7 +67,7 @@ const bdlat_AttributeInfo balber::BerDecoderOptions::ATTRIBUTE_INFO_ARRAY[] = { sizeof("DefaultEmptyStrings") - 1, // name length "Option to decode empty strings as their default values", // annotation - bdlat_FormattingMode::e_TEXT // formatting mode + bdlat_FormattingMode::e_TEXT // formatting mode } }; diff --git a/groups/bal/balber/balber_berdecoderoptions.h b/groups/bal/balber/balber_berdecoderoptions.h index 0d2f03220b..bc9b736a0f 100644 --- a/groups/bal/balber/balber_berdecoderoptions.h +++ b/groups/bal/balber/balber_berdecoderoptions.h @@ -1,12 +1,4 @@ // balber_berdecoderoptions.h -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #ifndef INCLUDED_BALBER_BERDECODEROPTIONS #define INCLUDED_BALBER_BERDECODEROPTIONS @@ -26,13 +18,13 @@ BSLS_IDENT("$Id: $") #include #include +#include + #include #include #include -#include - #include namespace BloombergLP { diff --git a/groups/bal/balber/balber_berdecoderoptions.t.cpp b/groups/bal/balber/balber_berdecoderoptions.t.cpp index 753a3e59d0..8df052cca9 100644 --- a/groups/bal/balber/balber_berdecoderoptions.t.cpp +++ b/groups/bal/balber/balber_berdecoderoptions.t.cpp @@ -1,12 +1,4 @@ // balber_berdecoderoptions.t.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include #include diff --git a/groups/bal/balber/balber_berencoder.cpp b/groups/bal/balber/balber_berencoder.cpp index 9394dd1648..e6bab9a540 100644 --- a/groups/bal/balber/balber_berencoder.cpp +++ b/groups/bal/balber/balber_berencoder.cpp @@ -1,18 +1,11 @@ // balber_berencoder.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include #include BSLS_IDENT_RCSID(balber_berencoder_cpp,"$Id$ $CSID$") #include + #include namespace BloombergLP { diff --git a/groups/bal/balber/balber_berencoder.h b/groups/bal/balber/balber_berencoder.h index c5eec7613a..27c301248e 100644 --- a/groups/bal/balber/balber_berencoder.h +++ b/groups/bal/balber/balber_berencoder.h @@ -1,12 +1,4 @@ // balber_berencoder.h -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #ifndef INCLUDED_BALBER_BERENCODER #define INCLUDED_BALBER_BERENCODER @@ -183,19 +175,18 @@ BSLS_IDENT("$Id: $") #include #include -#include - -#include - #include +#include + +#include #include #include +#include #include #include -#include namespace BloombergLP { namespace balber { diff --git a/groups/bal/balber/balber_berencoder.t.cpp b/groups/bal/balber/balber_berencoder.t.cpp index b5086ebeaf..89522b861f 100644 --- a/groups/bal/balber/balber_berencoder.t.cpp +++ b/groups/bal/balber/balber_berencoder.t.cpp @@ -1,14 +1,6 @@ // balber_berencoder.t.cpp -*-C++-*- - #include -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include #include diff --git a/groups/bal/balber/balber_berencoderoptions.t.cpp b/groups/bal/balber/balber_berencoderoptions.t.cpp index 4dcab0339a..9b3373e044 100644 --- a/groups/bal/balber/balber_berencoderoptions.t.cpp +++ b/groups/bal/balber/balber_berencoderoptions.t.cpp @@ -1,12 +1,4 @@ // balber_berencoderoptions.t.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include #include diff --git a/groups/bal/balber/balber_beruniversaltagnumber.cpp b/groups/bal/balber/balber_beruniversaltagnumber.cpp index 319950b94d..4cb6b18c6f 100644 --- a/groups/bal/balber/balber_beruniversaltagnumber.cpp +++ b/groups/bal/balber/balber_beruniversaltagnumber.cpp @@ -1,12 +1,4 @@ // balber_beruniversaltagnumber.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include #include diff --git a/groups/bal/balber/balber_beruniversaltagnumber.h b/groups/bal/balber/balber_beruniversaltagnumber.h index 4aa99060a5..9112d5c1da 100644 --- a/groups/bal/balber/balber_beruniversaltagnumber.h +++ b/groups/bal/balber/balber_beruniversaltagnumber.h @@ -1,12 +1,4 @@ // balber_beruniversaltagnumber.h -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #ifndef INCLUDED_BALBER_BERUNIVERSALTAGNUMBER #define INCLUDED_BALBER_BERUNIVERSALTAGNUMBER @@ -19,12 +11,12 @@ BSLS_IDENT("$Id: $") // balber::BerUniversalTagNumber: namespace universal tag number enumeration // //@SEE_ALSO: balber_berencoder, balber_berdecoder -// http://www.itu.int/ITU-T/studygroups/com17/languages/X.680-0207.pdf // //@DESCRIPTION: This component provides a namespace for the 'enum' type // 'balber::BerUniversalTagNumber::Value'. 'Value' enumerates the set of BER // universal tag numbers used by the BER encoder and decoder. The universal -// tag numbers are defined in the X.680 standard, in section 8. +// tag numbers are defined in the X.680 standard, in section 8 (See +// http://www.itu.int/ITU-T/studygroups/com17/languages/X.680-0207.pdf). // // In addition, this component supports functions that convert the 'Value' // enumerations to a well-defined ASCII representation. @@ -91,8 +83,8 @@ BSLS_IDENT("$Id: $") ///----- // This section illustrates intended use of this component. // -///Exercise 1: Basic Syntax -/// - - - - - - - - - - - - +///Example 1: Basic Syntax +///- - - - - - - - - - - - // The following snippets of code provide a simple illustration of // 'balber::BerUniversalTagNumber' operation. // diff --git a/groups/bal/balber/balber_beruniversaltagnumber.t.cpp b/groups/bal/balber/balber_beruniversaltagnumber.t.cpp index af38e44cd8..243c5fadb2 100644 --- a/groups/bal/balber/balber_beruniversaltagnumber.t.cpp +++ b/groups/bal/balber/balber_beruniversaltagnumber.t.cpp @@ -1,14 +1,6 @@ // balber_beruniversaltagnumber.t.cpp -*-C++-*- - #include -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include #include #include @@ -42,14 +34,13 @@ #include #include +#include // atoi() +#include // strlen() #include #include #include #include -#include // atoi() -#include // strlen() - using namespace BloombergLP; using bsl::cout; using bsl::cerr; diff --git a/groups/bal/balber/balber_berutil.cpp b/groups/bal/balber/balber_berutil.cpp index 7c3421025a..3e4b3d6d89 100644 --- a/groups/bal/balber/balber_berutil.cpp +++ b/groups/bal/balber/balber_berutil.cpp @@ -1,38 +1,23 @@ // balber_berutil.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include #include BSLS_IDENT_RCSID(balber_berutil_cpp, "$Id$ $CSID$") -#include - -#include - -#include - #include - +#include +#include #include - #include #include #include #include +#include +#include #include #include -#include - #include - #include #include #include diff --git a/groups/bal/balber/balber_berutil.t.cpp b/groups/bal/balber/balber_berutil.t.cpp index 4814abb359..265f5a057d 100644 --- a/groups/bal/balber/balber_berutil.t.cpp +++ b/groups/bal/balber/balber_berutil.t.cpp @@ -1,57 +1,44 @@ // balber_berutil.t.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include #include -#include - -#include - #include #include #include #include #include +#include +#include #include -#include -#include -#include -#include -#include - -#include - #include -#include -#include #include +#include +#include #include #include -#include -#include #include +#include #include +#include #include -#include -#include -#include - #include +#include + +#include + +#include +#include #include +#include +#include +#include #include #include diff --git a/groups/bal/balscm/balscm_version.t.cpp b/groups/bal/balscm/balscm_version.t.cpp index 4e12d525cb..f01086485f 100644 --- a/groups/bal/balscm/balscm_version.t.cpp +++ b/groups/bal/balscm/balscm_version.t.cpp @@ -1,25 +1,15 @@ // balscm_version.t.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - - #include +#include + #include #include // atoi() #include // strncmp() #include -#include - using namespace BloombergLP; -using namespace bsl; // automatically added by script - +using namespace bsl; //============================================================================= // TEST PLAN diff --git a/groups/bal/balscm/balscm_versiontag.cpp b/groups/bal/balscm/balscm_versiontag.cpp index 1d9fcca4f2..7b8a41d067 100644 --- a/groups/bal/balscm/balscm_versiontag.cpp +++ b/groups/bal/balscm/balscm_versiontag.cpp @@ -1,12 +1,4 @@ // balscm_versiontag.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include #include diff --git a/groups/bal/balscm/balscm_versiontag.h b/groups/bal/balscm/balscm_versiontag.h index 4fa289145d..0e1661799b 100644 --- a/groups/bal/balscm/balscm_versiontag.h +++ b/groups/bal/balscm/balscm_versiontag.h @@ -1,12 +1,4 @@ // balscm_versiontag.h -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #ifndef INCLUDED_BALSCM_VERSIONTAG #define INCLUDED_BALSCM_VERSIONTAG @@ -28,6 +20,10 @@ BSLS_IDENT("$Id: $") // ///Usage ///----- +// This section illustrates intended use of this component. +// +///Example 1: Basic Usage +/// - - - - - - - - - - - // At compile time, the version of BAL can be used to select an older or newer // way to accomplish a task, to enable new functionality, or to accommodate an // interface change. For example, if the name of a function changes (a rare diff --git a/groups/bal/balscm/balscm_versiontag.t.cpp b/groups/bal/balscm/balscm_versiontag.t.cpp index 10990bca1f..698934780c 100644 --- a/groups/bal/balscm/balscm_versiontag.t.cpp +++ b/groups/bal/balscm/balscm_versiontag.t.cpp @@ -1,21 +1,11 @@ // balscm_versiontag.t.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - - #include -#include +#include -#include // atoi() #include - -#include +#include // atoi() +#include using namespace BloombergLP; using namespace bsl; diff --git a/groups/bal/balst/balst_assertionlogger.cpp b/groups/bal/balst/balst_assertionlogger.cpp index 25b01788e0..d2e11836e8 100644 --- a/groups/bal/balst/balst_assertionlogger.cpp +++ b/groups/bal/balst/balst_assertionlogger.cpp @@ -1,12 +1,4 @@ // balst_assertionlogger.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include #include diff --git a/groups/bal/balst/balst_assertionlogger.h b/groups/bal/balst/balst_assertionlogger.h index 5fb4477d74..dc0056b680 100644 --- a/groups/bal/balst/balst_assertionlogger.h +++ b/groups/bal/balst/balst_assertionlogger.h @@ -1,12 +1,4 @@ // balst_assertionlogger.h -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #ifndef INCLUDED_BALST_ASSERTIONLOGGER #define INCLUDED_BALST_ASSERTIONLOGGER diff --git a/groups/bal/balst/balst_assertionlogger.t.cpp b/groups/bal/balst/balst_assertionlogger.t.cpp index e4e12809b9..0cc1455b12 100644 --- a/groups/bal/balst/balst_assertionlogger.t.cpp +++ b/groups/bal/balst/balst_assertionlogger.t.cpp @@ -1,13 +1,5 @@ // balst_assertionlogger.t.cpp -*-C++-*- -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - - // Try to force assertion in string to trigger, for the usage example. #undef BDE_BUILD_TARGET_SAFE_2 #define BDE_BUILD_TARGET_SAFE_2 @@ -25,11 +17,11 @@ #include -#include -#include -#include #include // atoi() #include // strcpy() +#include +#include +#include using namespace BloombergLP; using namespace bsl; diff --git a/groups/bal/balst/balst_objectfileformat.cpp b/groups/bal/balst/balst_objectfileformat.cpp index aee211764a..2cf8381ce8 100644 --- a/groups/bal/balst/balst_objectfileformat.cpp +++ b/groups/bal/balst/balst_objectfileformat.cpp @@ -1,12 +1,4 @@ // balst_objectfileformat.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include #include diff --git a/groups/bal/balst/balst_objectfileformat.h b/groups/bal/balst/balst_objectfileformat.h index 1dc84e293b..ce346d7a95 100644 --- a/groups/bal/balst/balst_objectfileformat.h +++ b/groups/bal/balst/balst_objectfileformat.h @@ -1,12 +1,4 @@ // balst_objectfileformat.h -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #ifndef INCLUDED_BALST_OBJECTFILEFORMAT #define INCLUDED_BALST_OBJECTFILEFORMAT @@ -61,7 +53,7 @@ BSLS_IDENT("$Id: $") // ///Usage ///----- -// In this section we show the intended usage of this component. +// This section illustrates intended use of this component. // ///Example 1: Accessing 'balst::ObjectFileFormat' Information at Run Time /// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/groups/bal/balst/balst_objectfileformat.t.cpp b/groups/bal/balst/balst_objectfileformat.t.cpp index 853956c38d..c248c828aa 100644 --- a/groups/bal/balst/balst_objectfileformat.t.cpp +++ b/groups/bal/balst/balst_objectfileformat.t.cpp @@ -1,21 +1,13 @@ // balst_objectfileformat.t.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include #include -#include #include // atoi() +#include using namespace BloombergLP; -using namespace bsl; // automatically added by script +using namespace bsl; //============================================================================= // TEST PLAN diff --git a/groups/bal/balst/balst_resolver_filehelper.cpp b/groups/bal/balst/balst_resolver_filehelper.cpp index 2622b20227..009123f6e7 100644 --- a/groups/bal/balst/balst_resolver_filehelper.cpp +++ b/groups/bal/balst/balst_resolver_filehelper.cpp @@ -1,12 +1,4 @@ // balst_resolver_filehelper.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include #include diff --git a/groups/bal/balst/balst_resolver_filehelper.h b/groups/bal/balst/balst_resolver_filehelper.h index 2d73b35fc7..3265fc5bea 100644 --- a/groups/bal/balst/balst_resolver_filehelper.h +++ b/groups/bal/balst/balst_resolver_filehelper.h @@ -1,12 +1,4 @@ // balst_resolver_filehelper.h -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #ifndef INCLUDED_BALST_RESOLVER_FILEHELPER #define INCLUDED_BALST_RESOLVER_FILEHELPER @@ -18,8 +10,7 @@ BSLS_IDENT("$Id: $") //@CLASSES: // balst::Resolver_FileHelper: file input for stack trace resolvers // -//@SEE_ALSO: balst_resolverimpl_elf, -// balst_resolverimpl_xcoff +//@SEE_ALSO: balst_resolverimpl_elf, balst_resolverimpl_xcoff // //@DESCRIPTION: The one class in this component opens a file in readonly mode // and then owns the file descriptor, and provides 3 utility functions for @@ -31,6 +22,11 @@ BSLS_IDENT("$Id: $") // ///Usage ///----- +// This section illustrates intended use of this component. +// +///Example 1: Basic Usage +/// - - - - - - - - - - - +// First, we prepare the file to be used by this usage example: //.. // bslma::TestAllocator ta; // @@ -43,7 +39,7 @@ BSLS_IDENT("$Id: $") //.. // bdls::FilesystemUtil::remove(fileNameBuffer); //.. -// Next, Create the file and open a file descriptor to it. The boolean +// Next, create the file and open a file descriptor to it. The boolean // flags indicate that the file is writable, and not previously existing // (and therefore must be created). //.. diff --git a/groups/bal/balst/balst_resolver_filehelper.t.cpp b/groups/bal/balst/balst_resolver_filehelper.t.cpp index fbbf0940e8..013db6ccc8 100644 --- a/groups/bal/balst/balst_resolver_filehelper.t.cpp +++ b/groups/bal/balst/balst_resolver_filehelper.t.cpp @@ -1,17 +1,10 @@ // balst_resolver_filehelper.t.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include -#include #include +#include + #include #include diff --git a/groups/bal/balst/balst_resolverimpl_dladdr.cpp b/groups/bal/balst/balst_resolverimpl_dladdr.cpp index f06752e812..e39f03f688 100644 --- a/groups/bal/balst/balst_resolverimpl_dladdr.cpp +++ b/groups/bal/balst/balst_resolverimpl_dladdr.cpp @@ -1,12 +1,4 @@ // balst_resolverimpl_dladdr.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include #include @@ -18,13 +10,13 @@ BSLS_IDENT_RCSID(balst_resolverimpl_dladdr,"$Id$ $CSID$") #include -#include - #include #include #include +#include + #include // The following is an excerpt from '#include '. Unfortunately, that diff --git a/groups/bal/balst/balst_resolverimpl_dladdr.h b/groups/bal/balst/balst_resolverimpl_dladdr.h index a7e88834c7..6e0443fc4f 100644 --- a/groups/bal/balst/balst_resolverimpl_dladdr.h +++ b/groups/bal/balst/balst_resolverimpl_dladdr.h @@ -1,12 +1,4 @@ // balst_resolverimpl_dladdr.h -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #ifndef INCLUDED_BALST_RESOLVERIMPL_DLADDR #define INCLUDED_BALST_RESOLVERIMPL_DLADDR diff --git a/groups/bal/balst/balst_resolverimpl_dladdr.t.cpp b/groups/bal/balst/balst_resolverimpl_dladdr.t.cpp index b0cdab7154..e0e25eb94d 100644 --- a/groups/bal/balst/balst_resolverimpl_dladdr.t.cpp +++ b/groups/bal/balst/balst_resolverimpl_dladdr.t.cpp @@ -1,17 +1,8 @@ // balst_resolverimpl_dladdr.t.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include -#include - #include +#include #include diff --git a/groups/bal/balst/balst_resolverimpl_elf.cpp b/groups/bal/balst/balst_resolverimpl_elf.cpp index 3f40f8cc9b..72753da022 100644 --- a/groups/bal/balst/balst_resolverimpl_elf.cpp +++ b/groups/bal/balst/balst_resolverimpl_elf.cpp @@ -1,12 +1,4 @@ // balst_resolverimpl_elf.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include #include diff --git a/groups/bal/balst/balst_resolverimpl_elf.h b/groups/bal/balst/balst_resolverimpl_elf.h index 265d0fe630..3b30819dda 100644 --- a/groups/bal/balst/balst_resolverimpl_elf.h +++ b/groups/bal/balst/balst_resolverimpl_elf.h @@ -1,12 +1,4 @@ // balst_resolverimpl_elf.h -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #ifndef INCLUDED_BALST_RESOLVERIMPL_ELF #define INCLUDED_BALST_RESOLVERIMPL_ELF diff --git a/groups/bal/balst/balst_resolverimpl_elf.t.cpp b/groups/bal/balst/balst_resolverimpl_elf.t.cpp index 6ebf195b37..ea92cac9ab 100644 --- a/groups/bal/balst/balst_resolverimpl_elf.t.cpp +++ b/groups/bal/balst/balst_resolverimpl_elf.t.cpp @@ -1,17 +1,8 @@ // balst_resolverimpl_elf.t.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include -#include - #include +#include #include #include diff --git a/groups/bal/balst/balst_resolverimpl_windows.cpp b/groups/bal/balst/balst_resolverimpl_windows.cpp index f339617400..edb93a5c80 100644 --- a/groups/bal/balst/balst_resolverimpl_windows.cpp +++ b/groups/bal/balst/balst_resolverimpl_windows.cpp @@ -1,12 +1,4 @@ // balst_resolverimpl_windows.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include #include diff --git a/groups/bal/balst/balst_resolverimpl_windows.h b/groups/bal/balst/balst_resolverimpl_windows.h index 83114f9f8f..383a7fa132 100644 --- a/groups/bal/balst/balst_resolverimpl_windows.h +++ b/groups/bal/balst/balst_resolverimpl_windows.h @@ -1,12 +1,4 @@ // balst_resolverimpl_windows.h -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #ifndef INCLUDED_BALST_RESOLVERIMPL_WINDOWS #define INCLUDED_BALST_RESOLVERIMPL_WINDOWS diff --git a/groups/bal/balst/balst_resolverimpl_windows.t.cpp b/groups/bal/balst/balst_resolverimpl_windows.t.cpp index 5e53a4b8b3..9a1d6b6bbd 100644 --- a/groups/bal/balst/balst_resolverimpl_windows.t.cpp +++ b/groups/bal/balst/balst_resolverimpl_windows.t.cpp @@ -1,12 +1,4 @@ // balst_resolverimpl_windows.t.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include #include diff --git a/groups/bal/balst/balst_resolverimpl_xcoff.cpp b/groups/bal/balst/balst_resolverimpl_xcoff.cpp index 20007d7863..25b3ded679 100644 --- a/groups/bal/balst/balst_resolverimpl_xcoff.cpp +++ b/groups/bal/balst/balst_resolverimpl_xcoff.cpp @@ -1,12 +1,4 @@ // balst_resolverimpl_xcoff.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include #include @@ -16,12 +8,9 @@ BSLS_IDENT_RCSID(balst_resolverimpl_xcoff_cpp,"$Id$ $CSID$") #ifdef BALST_OBJECTFILEFORMAT_RESOLVER_XCOFF -#include -#include #include - -#include -#include +#include +#include #include #include @@ -29,6 +18,9 @@ BSLS_IDENT_RCSID(balst_resolverimpl_xcoff_cpp,"$Id$ $CSID$") #include +#include +#include + #include #include #include diff --git a/groups/bal/balst/balst_resolverimpl_xcoff.h b/groups/bal/balst/balst_resolverimpl_xcoff.h index 7fde85bc5f..f0851e1f28 100644 --- a/groups/bal/balst/balst_resolverimpl_xcoff.h +++ b/groups/bal/balst/balst_resolverimpl_xcoff.h @@ -1,12 +1,4 @@ // balst_resolverimpl_xcoff.h -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #ifndef INCLUDED_BALST_RESOLVERIMPL_XCOFF #define INCLUDED_BALST_RESOLVERIMPL_XCOFF @@ -22,10 +14,9 @@ BSLS_IDENT("$Id: $") // balst_resolverimpl_windows // //@DESCRIPTION: This component provides a class, -// balst::Resolver, that, given a vector of -// 'balst::StackTraceFrame's that have only their 'address' fields set, -// resolves all other fields in those frames. Xcoff objects are used on AIX -// platforms. +// 'balst::Resolver', that, given a vector of 'balst::StackTraceFrame's +// that have only their 'address' fields set, resolves all other fields in +// those frames. Xcoff objects are used on AIX platforms. // ///Inline Functions ///---------------- @@ -49,16 +40,17 @@ BSLS_IDENT("$Id: $") #include #include -#include - #include #include +#include + +#include + #include #include -#include struct syment; // defined in imp by included file '' union auxent; // defined in imp by included file '' diff --git a/groups/bal/balst/balst_resolverimpl_xcoff.t.cpp b/groups/bal/balst/balst_resolverimpl_xcoff.t.cpp index 568b3b99c3..f932f3e1ac 100644 --- a/groups/bal/balst/balst_resolverimpl_xcoff.t.cpp +++ b/groups/bal/balst/balst_resolverimpl_xcoff.t.cpp @@ -1,12 +1,4 @@ // balst_resolverimpl_xcoff.t.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include #include diff --git a/groups/bal/balst/balst_stacktrace.cpp b/groups/bal/balst/balst_stacktrace.cpp index 82f1066743..0f6e5dfe6f 100644 --- a/groups/bal/balst/balst_stacktrace.cpp +++ b/groups/bal/balst/balst_stacktrace.cpp @@ -1,12 +1,4 @@ // balst_stacktrace.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include #include diff --git a/groups/bal/balst/balst_stacktrace.h b/groups/bal/balst/balst_stacktrace.h index c28407dd4f..fbfc582fdc 100644 --- a/groups/bal/balst/balst_stacktrace.h +++ b/groups/bal/balst/balst_stacktrace.h @@ -1,12 +1,4 @@ // balst_stacktrace.h -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #ifndef INCLUDED_BALST_STACKTRACE #define INCLUDED_BALST_STACKTRACE @@ -30,7 +22,7 @@ BSLS_IDENT("$Id: $") // ///Usage ///----- -// In this section we show the intended usage of this component. +// This section illustrates intended use of this component. // ///Example 1: Configuring a Stack-Trace Value /// - - - - - - - - - - - - - - - - - - - - - diff --git a/groups/bal/balst/balst_stacktrace.t.cpp b/groups/bal/balst/balst_stacktrace.t.cpp index cf1358287f..6bc59073cb 100644 --- a/groups/bal/balst/balst_stacktrace.t.cpp +++ b/groups/bal/balst/balst_stacktrace.t.cpp @@ -1,12 +1,4 @@ // balst_stacktrace.t.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include #include diff --git a/groups/bal/balst/balst_stacktraceframe.cpp b/groups/bal/balst/balst_stacktraceframe.cpp index 12e1d6abc4..bbfb053445 100644 --- a/groups/bal/balst/balst_stacktraceframe.cpp +++ b/groups/bal/balst/balst_stacktraceframe.cpp @@ -1,12 +1,4 @@ // balst_stacktraceframe.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include #include diff --git a/groups/bal/balst/balst_stacktraceframe.h b/groups/bal/balst/balst_stacktraceframe.h index 1a65cdd3e6..a87b6c6a51 100644 --- a/groups/bal/balst/balst_stacktraceframe.h +++ b/groups/bal/balst/balst_stacktraceframe.h @@ -1,12 +1,4 @@ // balst_stacktraceframe.h -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #ifndef INCLUDED_BALST_STACKTRACEFRAME #define INCLUDED_BALST_STACKTRACEFRAME @@ -76,9 +68,14 @@ BSLS_IDENT("$Id: $") // ///Usage ///----- +// This section illustrates intended use of this component. +// +///Example 1: Basic Usage +/// - - - - - - - - - - - // In this example, we create two 'balst::StackTraceFrame' objects, modify -// their properties, and compare them. First, we create the objects 'a' and -// 'b': +// their properties, and compare them. +// +// First, we create the objects 'a' and 'b': //.. // balst::StackTraceFrame a, b; // assert(a == b); diff --git a/groups/bal/balst/balst_stacktraceframe.t.cpp b/groups/bal/balst/balst_stacktraceframe.t.cpp index 670b5777f0..314c03cb03 100644 --- a/groups/bal/balst/balst_stacktraceframe.t.cpp +++ b/groups/bal/balst/balst_stacktraceframe.t.cpp @@ -1,19 +1,12 @@ // balst_stacktraceframe.t.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include #include -#include #include +#include + #include #include diff --git a/groups/bal/balst/balst_stacktraceprintutil.cpp b/groups/bal/balst/balst_stacktraceprintutil.cpp index 708224ae27..970a5c2bbb 100644 --- a/groups/bal/balst/balst_stacktraceprintutil.cpp +++ b/groups/bal/balst/balst_stacktraceprintutil.cpp @@ -1,12 +1,4 @@ // balst_stacktraceprintutil.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include #include diff --git a/groups/bal/balst/balst_stacktraceprintutil.h b/groups/bal/balst/balst_stacktraceprintutil.h index 63819a3348..237c5c14ec 100644 --- a/groups/bal/balst/balst_stacktraceprintutil.h +++ b/groups/bal/balst/balst_stacktraceprintutil.h @@ -1,12 +1,4 @@ // balst_stacktraceprintutil.h -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #ifndef INCLUDED_BALST_STACKTRACEPRINTUTIL #define INCLUDED_BALST_STACKTRACEPRINTUTIL diff --git a/groups/bal/balst/balst_stacktraceprintutil.t.cpp b/groups/bal/balst/balst_stacktraceprintutil.t.cpp index d1fac6cb20..6bf0e3b28e 100644 --- a/groups/bal/balst/balst_stacktraceprintutil.t.cpp +++ b/groups/bal/balst/balst_stacktraceprintutil.t.cpp @@ -1,12 +1,4 @@ // balst_stacktraceprintutil.t.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include #include @@ -29,15 +21,14 @@ #include #include +#include +#include +#include #include #include #include #include -#include -#include -#include - #include #include diff --git a/groups/bal/balst/balst_stacktracetestallocator.cpp b/groups/bal/balst/balst_stacktracetestallocator.cpp index fc7eb86613..6d132233c4 100644 --- a/groups/bal/balst/balst_stacktracetestallocator.cpp +++ b/groups/bal/balst/balst_stacktracetestallocator.cpp @@ -1,12 +1,4 @@ // balst_stacktracetestallocator.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include #include @@ -17,12 +9,13 @@ BSLS_IDENT_RCSID(balst_stacktracetestallocator_cpp,"$Id$ $CSID$") #include -#include - #include #include + #include +#include + #include #include #include diff --git a/groups/bal/balst/balst_stacktracetestallocator.h b/groups/bal/balst/balst_stacktracetestallocator.h index b2048b3866..cb80265013 100644 --- a/groups/bal/balst/balst_stacktracetestallocator.h +++ b/groups/bal/balst/balst_stacktracetestallocator.h @@ -1,12 +1,4 @@ // balst_stacktracetestallocator.h -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #ifndef INCLUDED_BALST_STACKTRACETESTALLOCATOR #define INCLUDED_BALST_STACKTRACETESTALLOCATOR @@ -97,6 +89,10 @@ BSLS_IDENT("$Id: $") // ///Usage ///----- +// This section illustrates intended use of this component. +// +///Example 1: Basic Usage +/// - - - - - - - - - - - // In this example, we will define a class 'ShipsCrew' that does something, // but leaks memory, and then we will demonstrate the use of the stack trace // test allocator to locate the leak. diff --git a/groups/bal/balst/balst_stacktracetestallocator.t.cpp b/groups/bal/balst/balst_stacktracetestallocator.t.cpp index 1f8c2bdcb3..bf078f16f1 100644 --- a/groups/bal/balst/balst_stacktracetestallocator.t.cpp +++ b/groups/bal/balst/balst_stacktracetestallocator.t.cpp @@ -1,25 +1,13 @@ // balst_stacktracetestallocator.t.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include #include #include -#include -#include -#include - -#include -#include #include #include +#include +#include #include @@ -27,10 +15,13 @@ #include #include #include -#include -#include #include +#include #include // for testing only +#include + +#include +#include #include #include diff --git a/groups/bal/balst/balst_stacktraceutil.cpp b/groups/bal/balst/balst_stacktraceutil.cpp index 965a180cd8..fbb5236310 100644 --- a/groups/bal/balst/balst_stacktraceutil.cpp +++ b/groups/bal/balst/balst_stacktraceutil.cpp @@ -1,12 +1,4 @@ // balst_stacktraceutil.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include #include @@ -23,6 +15,7 @@ BSLS_IDENT_RCSID(balst_stacktraceutil_cpp,"$Id$ $CSID$") #include #include + #include #include #include diff --git a/groups/bal/balst/balst_stacktraceutil.h b/groups/bal/balst/balst_stacktraceutil.h index e8d213e3c8..175cfd0ea7 100644 --- a/groups/bal/balst/balst_stacktraceutil.h +++ b/groups/bal/balst/balst_stacktraceutil.h @@ -1,12 +1,4 @@ // balst_stacktraceutil.h -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #ifndef INCLUDED_BALST_STACKTRACEUTIL #define INCLUDED_BALST_STACKTRACEUTIL @@ -27,10 +19,11 @@ BSLS_IDENT("$Id: $") // ///Usage ///----- -// This section illustrates intended usage for this component. The following -// examples demonstrate two distinct ways to load and print a stack-trace with -// 'balst::StackTraceUtil' using (1) 'loadStackTraceFromStack' and -// (2) 'loadStackTraceFromAddresses'. +// This section illustrates intended usage for this component. +// +// The following examples demonstrate two distinct ways to load and print a +// stack-trace with 'balst::StackTraceUtil' using (1) 'loadStackTraceFromStack' +// and (2) 'loadStackTraceFromAddresses'. // ///Example 1: Loading Stack-Trace Directly from the Stack /// - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/groups/bal/balst/balst_stacktraceutil.t.cpp b/groups/bal/balst/balst_stacktraceutil.t.cpp index 0f24c1f11c..1ad44601b7 100644 --- a/groups/bal/balst/balst_stacktraceutil.t.cpp +++ b/groups/bal/balst/balst_stacktraceutil.t.cpp @@ -1,17 +1,9 @@ // balst_stacktraceutil.t.cpp -*-C++-*- - -// ---------------------------------------------------------------------------- -// NOTICE -// -// This component is not up to date with current BDE coding standards, and -// should not be used as an example for new development. -// ---------------------------------------------------------------------------- - #include #include -#include #include +#include #include #include @@ -27,6 +19,7 @@ #include #include + #include #include #include