fixed two formulations, as suggested by @fingolfin

lib/list.gd

@@ -59,8 +59,7 @@ BIND_GLOBAL( "ListsFamily", NewFamily( "ListsFamily", IsList ) );
 ##
 ##  <Description>
 ##  &GAP; lists created by entering comma separated values in square brackets
-##  are represented internally as so-called <E>plain lists</E>,
-##  see <Ref Filt="IsPlistRep"/>.
+##  are usually represented internally as so-called <E>plain lists</E>.
 ##  Other representations of lists are <Ref Filt="IsBlistRep"/>,
 ##  <Ref Filt="IsRangeRep"/>, <Ref Filt="IsStringRep"/>,
 ##  or the ones that are chosen for implementing enumerators,

lib/type.g

@@ -408,15 +408,15 @@ DeclareRepresentation( "IsAtomicPositionalObjectRep",
 ##  1
 ##  false
 ##  ]]></Example>
-##  <!--
-##  The name of the  component that holds  the value of  an attribute is  the
-##  name of the attribute, with the first letter turned to lower case.
-##  This will be changed eventually, in order to avoid conflicts between
-##  ordinary components and components corresponding to attributes.-->
 ##  </Description>
 ##  </ManSection>
 ##  <#/GAPDoc>
 ##
+##  Note that we do not promise anything about
+##  the component names used for storing attribute values.
+##  (In earlier versions of GAP, a rule had been stated in a code file,
+##  but this rule was not part of the manuals.)
+##
 DeclareRepresentation( "IsAttributeStoringRep",
     IsComponentObjectRep, [], IS_OBJECT );