Mark IsLexicographicallyLess as deprecated

gap-system · May 21, 2021 · df2bac3 · df2bac3
1 parent c745dba
commit df2bac3
Show file tree

Hide file tree

Showing 4 changed files with 33 additions and 32 deletions.
diff --git a/doc/ref/lists.xml b/doc/ref/lists.xml
@@ -1658,7 +1658,6 @@ with possibly slightly different meaning for lists and non-list collections.
 <#Include Label="Flat">
 <#Include Label="Reversed">
 <#Include Label="Shuffle">
-<#Include Label="IsLexicographicallyLess">
 <#Include Label="Apply">
 <#Include Label="Perform">
 <#Include Label="PermListList">

diff --git a/doc/ref/obsolete.xml b/doc/ref/obsolete.xml
@@ -27,32 +27,32 @@ We decided to change the names to avoid confusion with the term
 <P/>
 Here are some examples of such name changes.
 <P/>
-<Index Key="Operation"><C>Operation</C></Index>
-<Index Key="RepresentativeOperation"><C>RepresentativeOperation</C></Index>
-<Index Key="OperationHomomorphism"><C>OperationHomomorphism</C></Index>
-<Index Key="FunctionOperation"><C>FunctionOperation</C></Index>
 <Table Align="l|l">
 <Row>
  <Item><E>OLD</E></Item>
  <Item><E>NOW USE</E></Item>
 </Row>
 <HorLine/>
 <Row>
- <Item><C>Operation</C></Item>
+ <Item><C>Operation</C><Index Key="Operation"><C>Operation</C></Index></Item>
  <Item><Ref Func="Action" Label="for a group, an action domain, etc."/></Item>
 </Row>
 <Row>
- <Item><C>RepresentativeOperation</C></Item>
+ <Item><C>RepresentativeOperation</C><Index Key="RepresentativeOperation"><C>RepresentativeOperation</C></Index></Item>
  <Item><Ref Func="RepresentativeAction"/></Item>
 </Row>
 <Row>
- <Item><C>OperationHomomorphism</C></Item>
+ <Item><C>OperationHomomorphism</C><Index Key="OperationHomomorphism"><C>OperationHomomorphism</C></Index></Item>
  <Item><Ref Func="ActionHomomorphism" Label="for a group, an action domain, etc."/></Item>
 </Row>
 <Row>
- <Item><C>FunctionOperation</C></Item>
+ <Item><C>FunctionOperation</C><Index Key="FunctionOperation"><C>FunctionOperation</C></Index></Item>
  <Item><Ref Attr="FunctionAction"/></Item>
 </Row>
+<Row>
+ <Item><C>IsLexicographicallyLess</C><Index Key="IsLexicographicallyLess"><C>IsLexicographicallyLess</C></Index></Item>
+ <Item><Ref Attr="\&lt;"/></Item>
+</Row>
 </Table>
 
 </Section>

diff --git a/lib/list.gd b/lib/list.gd
@@ -1599,29 +1599,6 @@ DeclareOperation( "ReversedOp", [ IsDenseList ] );
 ## 
 DeclareOperation( "Shuffle", [IsDenseList and IsMutable] );
 
-#############################################################################
-##
-#F IsLexicographicallyLess( <list1>, <list2> )
-##
-## <#GAPDoc Label="IsLexicographicallyLess">
-## <ManSection>
-## <Func Name="IsLexicographicallyLess" Arg='list1, list2'/>
-##
-## <Description>
-## Let <A>list1</A> and <A>list2</A> be two dense, but not necessarily
-## homogeneous lists
-## (see&nbsp;<Ref Filt="IsDenseList"/>, <Ref Filt="IsHomogeneousList"/>),
-## such that for each <M>i</M>, the entries in both lists at position
-## <M>i</M> can be compared via <C>&lt;</C>.
-## <Ref Func="IsLexicographicallyLess"/> returns <K>true</K> if <A>list1</A>
-## is smaller than <A>list2</A> w.r.t.&nbsp;lexicographical ordering,
-## and <K>false</K> otherwise.
-## </Description>
-## </ManSection>
-## <#/GAPDoc>
-##
-DeclareSynonym( "IsLexicographicallyLess", \< );
-
 
 #############################################################################
 ##

diff --git a/lib/obsolete.gd b/lib/obsolete.gd
@@ -722,3 +722,28 @@ end);
 DeclareObsoleteSynonym("GAP_EXIT_CODE", "GapExitCode", 2);
 DeclareObsoleteSynonym("QUIT_GAP", "QuitGap", 2);
 DeclareObsoleteSynonym("FORCE_QUIT_GAP", "ForceQuitGap", 2);
+
+
+#############################################################################
+##
+#F IsLexicographicallyLess( <list1>, <list2> )
+##
+## <#GAPDoc Label="IsLexicographicallyLess">
+## <ManSection>
+## <Func Name="IsLexicographicallyLess" Arg='list1, list2'/>
+##
+## <Description>
+## Let <A>list1</A> and <A>list2</A> be two dense, but not necessarily
+## homogeneous lists
+## (see&nbsp;<Ref Filt="IsDenseList"/>, <Ref Filt="IsHomogeneousList"/>),
+## such that for each <M>i</M>, the entries in both lists at position
+## <M>i</M> can be compared via <C>&lt;</C>.
+## <Ref Func="IsLexicographicallyLess"/> returns <K>true</K> if <A>list1</A>
+## is smaller than <A>list2</A> w.r.t.&nbsp;lexicographical ordering,
+## and <K>false</K> otherwise.
+## </Description>
+## </ManSection>
+## <#/GAPDoc>
+##
+## Not used in any redistributed package (05/2021)
+DeclareObsoleteSynonym( "IsLexicographicallyLess", "<" );