bslfwd.txt @PURPOSE: Provide compatibility for clients using single-level namespace @DEPRECATED: Do not use. @MNEMONIC: Basic Standard Library System ForWarding Declarations (bslfwd) @DESCRIPTION: Each component of this package provides a code snippet defining a forward reference to a corresponding type within 'bsl' (e.g., 'bslfwd_bslma_allocator' defines a forward reference to the type defined in 'bslma_allocator'). If 'BSLFWD_BUILDTARGET_BSL_USING_NAMESPACES' is defined, the forward declaration will refer the 'bsl' type in the two-level namespace; otherwise, it will refer to the type in the legacy single-level namespace (e.g., 'bslma::Allocator' versus 'bslma_Allocator', both in the 'BloombergLP' namespace). The components in this package are provided to provide backward compatibility for existing clients. All new code must be written using the two-level namespace for 'bsl' types. /Hierarchical Synopsis /--------------------- The 'bslfwd' package currently has 8 components having 2 levels of physical dependency. The list below shows the hierarchical ordering of the components. The order of components within each level is not architecturally significant, just alphabetical. .. 2. bslfwd_bslma_allocator !DEPRECATED! bslfwd_bslma_default !DEPRECATED! bslfwd_bslma_defaultallocatorguard !DEPRECATED! bslfwd_bslmf_nil !DEPRECATED! bslfwd_bsls_asserttestexception !DEPRECATED! bslfwd_bsls_stopwatch !DEPRECATED! bslfwd_bsls_types !DEPRECATED! 1. bslfwd_buildtarget !DEPRECATED! !PRIVATE! .. /Component Synopsis /------------------ : 'bslfwd_bslma_allocator': !DEPRECATED! : Provide a forward-declaration for the corresponding BDE type. : : 'bslfwd_bslma_default': !DEPRECATED! : Provide a forward-declaration for the corresponding BDE type. : : 'bslfwd_bslma_defaultallocatorguard': !DEPRECATED! : Provide a forward-declaration for the corresponding BDE type. : : 'bslfwd_bslmf_nil': !DEPRECATED! : Provide a forward-declaration for the corresponding BDE type. : : 'bslfwd_bsls_asserttestexception': !DEPRECATED! : Provide a forward-declaration for the corresponding BDE type. : : 'bslfwd_bsls_stopwatch': !DEPRECATED! : Provide a forward-declaration for the corresponding BDE type. : : 'bslfwd_bsls_types': !DEPRECATED! : Provide a forward-declaration for the corresponding BDE type. : : 'bslfwd_buildtarget': !DEPRECATED! !PRIVATE! : Supply a compile-time indicator of whether BSL uses C++ namespaces. /Usage /----- See "Updating 'bsl' Clients for Two-Level Namespaces" at 'https://bbiportal.bloomberg.com/BDE/Solutions/BSLFWD.html'