DOC: Incorrect Syntax for TAG() and DESCENDING() Commands

MORE INFORMATION

The text of the TAG() and DESCENDING() functions in the Visual FoxPro Help notes that the syntax is as follows: The text incorrectly shows the nTagNumber and nIndexNumber arguments, for TAG() and DESCENDING() functions respectively, as required.

The syntax should be as follows: The nTagNumber and nIndexNumer arguments are optional. If nTagNumber or nIndexnumber are not specified, then the TAG() and DESCENDING() functions will return information for the controlling Index of the table that is open in the current Work Area. If there is no table open, in the current Work Area or a controlling index is not in place, then TAG() returns an empty string and DESCENDING() returns a False.

To test this issue, create and run a program with the following code:

   CLEAR
   CLOSE ALL

   ?"Return values with no open Tables:"
      DO TagInfo

   CREATE DATABASE MyDbc
   CREATE TABLE MyTbl (Fld1 C(7) PRIMARY KEY, Fld2 C(4))
   INSERT INTO MyTbl VALUES("111-111","AAAA")
   INSERT INTO MyTbl VALUES("111-112","BBBB")
   INSERT INTO MyTbl VALUES("111-113","CCCC")

   ?"Return values with no controlling Index:"
      OPEN DATABASE MyDbc
      USE MyTbl
      DO TagInfo

   ?"Return values with controlling Index:"
      SET ORDER TO Fld1 DESCENDING
      DO TagInfo

   PROCEDURE TagInfo
      ?TAG()
      ?DESCENDING()