From 93668e2878796e1f3ea60011fadd618d046f5d1a Mon Sep 17 00:00:00 2001
From: ThomasBreuer <sam@math.rwth-aachen.de>
Date: Thu, 22 Aug 2019 08:55:29 +0200
Subject: [PATCH] fixed two formulations, as suggested by @fingolfin

---
 lib/list.gd |  3 +--
 lib/type.g  | 10 +++++-----
 2 files changed, 6 insertions(+), 7 deletions(-)

diff --git a/lib/list.gd b/lib/list.gd
index 103ca606d0..39cb4cbebc 100644
--- a/lib/list.gd
+++ b/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,
diff --git a/lib/type.g b/lib/type.g
index f2e22f404f..db50e03af6 100644
--- a/lib/type.g
+++ b/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 );