Proposal: Remove the “rules of FIND”

Informal

This proposal has been moved into this section. Its former address was: /standard/tools/BracketDEFINED

This page is dedicated to discussing this specific proposal

ContributeContributions

BerndPaysanavatar of BerndPaysan Remove the “rules of FIND”Proposal2019-09-12 09:09:51

Replace the parenthesis text “(according to the rules in the system's FIND)” with “in the current search order”. Since we don't have a term “search order” in the definitions of terms, section 2, only in the search order word set, move that to the definition of terms, and change it:

search order: A list of word lists specifying the order in which the dictionary will be searched (may contain only one word list).

to the definitions of terms.

AntonErtlavatar of AntonErtl

Replace "(may contain only one word list)" with a new sentence: If the search order wordset is not present, the search consists of all the word lists that contain definitions.

This should also include systems like cmForth which don#t have the search order wordset, but search several word lists in some circumstances.

BerndPaysanavatar of BerndPaysanNew Version

Hide differences

Replace the parenthesis text “(according to the rules in the system's FIND)” with “in the current search order”. Since we don't have a term “search order” in the definitions of terms, section 2, only in the search order word set, move that to the definition of terms, and change it:

search order:

A list of word lists specifying the order in which the dictionary will be searched (may contain only one word list).

A list of word lists specifying the order in which the dictionary will be searched. If the search order wordset is not present, the search order consists of all the word lists that contain definitions.

to the definitions of terms.

BerndPaysanavatar of BerndPaysanNew Version

Hide differences

Replace the parenthesis text “(according to the rules in the system's FIND)” with “in the current search order”. Since we don't have a term “search order” in the definitions of terms, section 2, only in the search order word set, move that to the definition of terms, and change it:

Replace the text

search order: A list of word lists specifying the order in which the dictionary will be searched. If the search order wordset is not present, the search order consists of all the word lists that contain definitions.

Return a true flag if name is the name of a word that can be found (according to the rules in the system's FIND); otherwise return a false flag.

to the definitions of terms.

with

Try to find name. Return a true flag if name can be found; otherwise return a false flag.

Add the following redefinition of the term “find” to 16.2:

find: To search the search order for a definition name matching a given string.

Cross-reference 2.1 find and 16.2 find.

AntonErtlavatar of AntonErtl

SEARCH-WORDLIST is specified as "Find ... in the word list identified by wid". So "find" in 16.2 may be better defined as:

find: To search the search order or a wordlist for a definition name matching a given string.

or

find: To search (without qualification) the search order or (when a wordlist is mentioned) the wordlist for a definition name matching a given string.

BerndPaysanavatar of BerndPaysanNew Version

Hide differences

Replace the text

Return a true flag if name is the name of a word that can be found (according to the rules in the system's FIND); otherwise return a false flag.

with

Try to find name. Return a true flag if name can be found; otherwise return a false flag.

Add the following redefinition of the term “find” to 16.2:

find:

To search the search order for a definition name matching a given string.

To search the search order or a specified wordlist for a definition name matching a given string.

Cross-reference 2.1 find and 16.2 find.

BerndPaysanavatar of BerndPaysanNew Version

Hide differences

Replace the text

Replace the text in [DEFINED]

Return a true flag if name is the name of a word that can be found (according to the rules in the system's FIND); otherwise return a false flag.

with

Try to find name. Return a true flag if name can be found; otherwise return a false flag.

Add the following redefinition of the term “find” to 16.2:

find: To search the search order or a specified wordlist for a definition name matching a given string.

Cross-reference 2.1 find and 16.2 find.

Reply New Version