fixed up some declspec syntax oddities per product team feedback (MicrosoftDocs#550)

mikeblome · Colin Robertson · commit a298993c9614 · 2018-01-24T15:17:44.000-08:00
diff --git a/docs/cpp/alignof-operator.md b/docs/cpp/alignof-operator.md
@@ -27,10 +27,7 @@ C++11 introduces the `alignof` operator that returns the alignment, in bytes, of
 ## Syntax  
   
 ```  
-  
-      __alignof(   
-   type    
-)  
+  __alignof( type )
 ```  
   
 ## Remarks  
diff --git a/docs/cpp/allocate.md b/docs/cpp/allocate.md
@@ -25,10 +25,9 @@ ms.workload: ["cplusplus"]
 ## Syntax  
   
 ```  
-  
-__declspec(allocate("  
-segname  
-")) declarator  
+
+   __declspec(allocate("segname")) declarator  
+
 ```  
   
 ## Remarks  
diff --git a/docs/cpp/declspec.md b/docs/cpp/declspec.md
@@ -17,7 +17,7 @@ ms.workload: ["cplusplus"]
 ---
 # __declspec
 
-## Microsoft Specific
+**Microsoft Specific**
 
 The extended attribute syntax for specifying storage-class information uses the **__declspec** keyword, which specifies that an instance of a given type is to be stored with a Microsoft-specific storage-class attribute listed below. Examples of other storage-class modifiers include the **static** and **extern** keywords. However, these keywords are part of the ANSI specification of the C and C++ languages, and as such are not covered by extended attribute syntax. The extended attribute syntax simplifies and standardizes Microsoft-specific extensions to the C and C++ languages.
 
@@ -83,7 +83,7 @@ The general guideline for using the **__declspec** attribute for simple declarat
 The *decl-specifier-seq* should contain, among other things, a base type (e.g. **int**, **float**, a **typedef**, or a class name), a storage class (e.g. **static**, **extern**), or the **__declspec** extension. The *init-declarator-list* should contain, among other things, the pointer part of declarations. For example:
 
 ```cpp
-__declspec(selectany) int * pi1 = 0;   //OK, selectany & int both part of decl-specifier
+__declspec(selectany) int * pi1 = 0;   //Recommended, selectany & int both part of decl-specifier
 int __declspec(selectany) * pi2 = 0;   //OK, selectany & int both part of decl-specifier
 int * __declspec(selectany) pi3 = 0;   //ERROR, selectany is not part of a declarator
 ```
diff --git a/docs/cpp/dllexport-dllimport.md b/docs/cpp/dllexport-dllimport.md
@@ -26,8 +26,8 @@ ms.workload: ["cplusplus"]
   
 ```  
   
-      __declspec( dllimport ) declarator  
-__declspec( dllexport ) declarator  
+   __declspec( dllimport ) declarator  
+   __declspec( dllexport ) declarator  
 ```  
   
 ## Remarks  
diff --git a/docs/cpp/property-cpp.md b/docs/cpp/property-cpp.md
@@ -26,9 +26,9 @@ ms.workload: ["cplusplus"]
   
 ```  
   
-      __declspec( property( get=get_func_name ) ) declarator  
-__declspec( property( put=put_func_name ) ) declarator  
-__declspec( property( get=get_func_name, put=put_func_name ) ) declarator  
+   __declspec( property( get=get_func_name ) ) declarator  
+   __declspec( property( put=put_func_name ) ) declarator  
+   __declspec( property( get=get_func_name, put=put_func_name ) ) declarator  
 ```  
   
 ## Remarks  
diff --git a/docs/cpp/uuid-cpp.md b/docs/cpp/uuid-cpp.md
@@ -26,9 +26,7 @@ ms.workload: ["cplusplus"]
   
 ```  
   
-__declspec( uuid("  
-ComObjectGUID  
-") ) declarator  
+__declspec( uuid("ComObjectGUID") ) declarator  
 ```  
   
 ## Remarks  
