The getopt module is the old-school command line option parser that supports the conventions established by the Unix function getopt().It parses an argument sequence, such as sys.argv and returns a sequence of (option, argument) pairs and a sequence of non-option arguments.. Sometimes with whitespace in between, sometimes not: Due to the very cryptic nature of these options, another style was developed that used long names. Using negation on a single letter option when bundling is in effect is pointless and will result in a warning. the detailed CPAN module installation guide, go to github issues (only if github is preferred repository). Command line operated programs traditionally take their arguments from the command line, for example filenames or other information that the program needs to know. Note that although this page shows the status of all builds of this package in PPM, including those available with the free Community Edition of ActivePerl, manually downloading modules (ppmx package files) is possible only with a Business Edition license. openSUSE Leap 15.1. openSUSE Oss x86_64. This function adheres to the POSIX syntax for command line options, with GNU extensions. To solve the problem, a solution is to use your perl installed in distribution. When a Perl script is executed the user can pass arguments on the command line in various ways. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. Early implementations of long options used a plus + instead. After installation you can check the installed Perl version by using the command. Development/Libraries. Whether command line arguments are allowed to be mixed with options. For example: A third style of bundling allows only values to be bundled with options. Most of the actual Getopt::Long code is not loaded until you really call one of its functions. Module Getopt::Long implements an extended getopt function called GetOptions(). The option requires an argument of the given type. FreeBSD NetBSD. Perl-getopt-long Download for Linux (rpm) Download perl-Getopt-Long linux packages for CentOS, Fedora, Mageia, OpenMandriva, PCLinuxOS. Also Read: How to install Python 3 on CentOS 7 Perl programming can be done by either executing Perl commands at the shell prompt or by writing them in a text file, and then executing it as a Perl Script. I can add instructions to the Makefile to remove them when you install this version. In the option specification, the option name is followed by an equals sign = and the letter s. The equals sign indicates that this option requires a value. Its argument can be: A string containing the text of a message to print before printing the standard message. yum install perl-Net-SNMP perl-Getopt-Long gcc./install.sh [root@icinga2 plugins]# ./install.sh ##### Manubulon snmp scripts installer ##### Will install all script(s) What is your perl location ? I have Quartus Prime Standard Edition 19.1 working on Ubuntu 18.04. TabDwukierunkowa. (Actually, it is an object that stringifies to the name of the option.) Note: disabling ignore_case also disables ignore_case_always. It is valid for the argument to start with - or --. Note that "make install" will usually require super, user privilege unless your Perl is installed in a location you have, It is also possible to use the CPAN or CPANPLUS tools to install. auto_version will be enabled if the calling program explicitly specified a version number higher than 2.32 in the use or require statement. Download perl-Complete-Getopt-Long-0.460.0-1.mga7.noarch.rpm for Mageia 7.1 from Mageia Core repository. For example, setting prefix_pattern to --|-|\+|\/ and long_prefix_pattern to --|\/ would add Win32 style argument handling. Note that min overrules the = / : semantics. Enabling this option will allow single-character options to be bundled. Setting the option value to true is often called enabling the option. Getopt::Long supports three styles of bundling. Bug reassigned from package 'perl' to 'perl-base,perl-modules-5.24'. conda install. option into a Getopt::Long? The default is \*STDERR unless the exit value is less than 2 (in which case the default is \*STDOUT). If the user passes --verbose on thecommand line, the variable $verbose will be set to some truevalue. Note that the characters !, |, +, =, and : can only appear as the first (or only) character of an alias. You can only obtain this using an alias, and Getopt::Long of at least version 2.13. E.g. Options sometimes take several values. no_ignore_case. Lua | 35 min ago . You can also use this behaviour to get non-default commandline option names and aliases. Can't locate Getopt/Long.pm in @INC (you may need to install the Getopt::Long module) Options. $ perl cli.pl undef $ perl cli.pl --verbose 1 $ perl cli.pl --noverbose 0 In certain situation this might be useful, though I have to admit, I have not encountered any such situation yet. The option name as specified to the GetOptions() function is called the option specification. When generating a Qsys project, I get the following error: This section describes briefly some of these 'features'. Also Read: How to install Python 3 on CentOS 7 Perl programming can be done by either executing Perl commands at the shell prompt or by writing them in a text file, and then executing it as a Perl Script. perl-Getopt-Long-2.40-5.638.noarch.rpm perl-Getopt-Long-2.40-5.638.src.rpm p5-Getopt-Long Perl module for extended processing of command line options 2.52 devel =52 2.52 Version of this port present on the latest quarterly branch. Note that to terminate options processing still requires a double dash --. It can be enabled with: Now, -h24 will set the option h to 24, but option bundles like -vxa and -h24w80 are flagged as errors. linux-64 v2.50. The second style of bundling lifts this restriction. Getopt::Long is the Perl5 successor of newgetopt.pl. Repeat specifiers are very similar to the {...} repeat specifiers that can be used with regular expression patterns. By default $verbose is undef and thus false. FreeBSD NetBSD. Usually, these single-character options can be bundled: Options can have values, the value is placed after the option character. "more+", when used with --more --more --more, will increment the value three times, resulting in a value of 3 (provided it was 0 or undefined at first). Sometimes, for example when there are a lot of options, having a separate variable for each of them can be cumbersome. RAW Paste Data Public Pastes. It takes a hash of parameter names and variable references which define the program’s API. That is, we'll check if $verbose is trueand if it is, then we print something to the cons… Case does not matter. Historically, they are preceded by a single dash -, and consist of a single letter. This is a short way of setting gnu_compat bundling permute no_getopt_compat. Version 2.33 of module Getopt::Long has been released to CPAN. To implement the above example: The first name is called the primary name, the other names are called aliases. conda install -c bioconda/label/cf201901 perl-getopt-long. Like =, but designates the argument as optional. Adélie Alpine ALT Linux Arch Linux CentOS Debian Fedora KaOS Mageia Mint OpenMandriva openSUSE OpenWrt PCLinuxOS Slackware Solus Ubuntu. Packages for openSUSE Leap 15.2:. Download perl-Getopt-Long-2.49.1-3.module_el8.1.0+229+cd132df8.noarch.rpm for CentOS 8 from CentOS AppStream repository. You signed in with another tab or window. @$libfiles would contain two strings upon completion: "lib/stdlib" and "lib/extlib", in that order. Can't locate Getopt/Long.pm when generating a Qsys Project Quartus 19.1 has issues with its perl distribution on Linux. #Documentation. When bundling is in effect, case is ignored on single-character options also. pkgs.org. Not enough search parameters. The only exception is when -- is used: This will call the callback routine for arg1 and arg2, and then terminate GetOptions() leaving "arg3" in @ARGV. The Getopt::Long module implements an extended getopt function called GetOptions(). Re : [Résolu] PERL -- erreur Getopt/Long.pm au démarrage humm… un fichier sabs aucun droit d'accès défini daté de l'an 0 de l'informatique (1 janv 1970) cela ne … The kit contains an "examples" directory with some program skeleton: files that can be used to start writing application programs. For example, --fpp-struct-return will set the variable $opt_fpp_struct_return. Popular examples are: Handling simple options is straightforward: The call to GetOptions() parses the command line arguments that are present in @ARGV and sets the option variable to the value 1 if the option did occur on the command line. If a hash is supplied (either as a reference or as a list) it should contain one or more elements with the following keys: The text of a message to print immediately prior to printing the program's usage message. pkgs.org. Usually programs take command line options as well as other arguments, for example, file names. For example: with command line "-size 10 -sizes 24 -sizes 48" will perform the equivalent of the assignments. The letter s indicates that this value is an arbitrary string. Like :i, but if the value is omitted, the current value for the option will be incremented. You have chosen search in content of rpms. For example: By default, GetOptions parses the options that are present in the global array @ARGV. To do this, the program will need to process a few arguments from the user - a perfect use case for Getopt::Long! Getopt::Long can be used in an object oriented way as well: Configuration options can be passed to the constructor: In version 2.37 the first argument to the callback function was changed from string to object. max denotes the maximum number of arguments. As of version 2.32 Getopt::Long provides auto-help, a quick and easy way to add the options --help and -? This was done to make room for extensions and more detailed control. Other characters that can't appear in Perl identifiers are also supported in aliases with Getopt::Long of at version 2.39. Other operating systems have other CLIs. Automatically provide support for the --help and -? The name specification contains the name of the option, optionally followed by a list of alternative names separated by vertical bar characters. I'm using defaults. Previous versions of Getopt::Long used variables for the purpose of configuring. It is also possible to specify that only integer or floating point numbers are acceptable values. If, however, bundling is enabled as well, single character options will be treated case-sensitive. The most simple options are the ones that take no values. The reference to the variable is called the option destination. When used like this, options and their possible values are removed from @myopts, the global @ARGV is not touched at all. Subscribe to RSS Feed; Mark Topic as New; Mark Topic as Read; Float this Topic for Current User; Bookmark; Subscribe; Mute; Printer Friendly Page; MUmar . If a constant string is not sufficient, see prefix_pattern. For a scalar or array destination, the second argument is the value to be stored. It will be standard part of Perl 5.8.1 and 5.9. Confusing? happy to offer a 10% discount on all, Mixing command line option with other arguments, User-defined subroutines to handle options, GetOptions does not return a false result when an option is not supplied, GetOptions does not split the command line correctly, Undefined subroutine &main::GetOptions called. So instead of a cryptic -l one could use the more descriptive --long. In this case, if no suitable value is supplied, string valued options get an empty string '' assigned, while numeric options are set to 0. It is also possible to specify that only integer or floating point numbers are acceptable values. With pass_through anything that is unknown, ambiguous or supplied with an invalid option will not be flagged as an error. Shall I add the remove instructions? Note: Using option bundling can easily lead to unexpected results, especially when mixing long options and bundles. cpanm Getopt::Long::Descriptive CPAN shell. An arbitrary sequence of characters. Its arguments argc and argv are the argument count and array as passed to themain() function on program invocation. If there is a type constraint defined, it will configure Getopt::Long to handle the option accordingly. See "Configuring Getopt::Long" for more details on how to configure Getopt::Long. Getopt::Long is the Perl5 successor of newgetopt.pl. See auto_help in section "Configuring Getopt::Long". Maintainer: perl@FreeBSD.org Port Added: 2001-06-11 01:34:56 Last Update: 2020-08-23 20:39:41 SVN Revision: 545892. To disable, prefix with no or no_, e.g. If the option destination is a reference to a hash, the option will take, as value, strings of the form key=value. to your program, and handle them. When configured for bundling, single-character options are matched case sensitive while long options are matched case insensitive. Automatically provide support for the --version option if the application did not specify a handler for this option itself. See also permute, which is the opposite of require_order. Download perl-Getopt-Long-2.49.1-1-omv2015.0.noarch.rpm for Lx 3.0 from OpenMandriva Contrib Updates repository. Maintainer: perl@FreeBSD.org Port Added: 2001-06-11 01:34:56 Last Update: 2020-08-23 20:39:41 SVN Revision: 545892. On Windows, it is COMMAND.COM or CMD.EXE. the hash %defines (or %$defines) will contain two keys, "os" with value "linux" and "vendor" with value "redhat". Settings. Pour savoir comment lancer le programme, faites perl nom_programme.pl -help ou perl nom_programme.pl -man A numeric value corresponding to the desired exit status. The second thing is that we need to enable the gnu_getopt configuration option of Getopt::Long by calling Getopt::Long::Configure qw(gnu_getopt); use Getopt::Long qw(GetOptions); Getopt::Long::Configure qw(gnu_getopt); After doing that we can now run $ perl cli.pl -df Foo debug Foo Mageia Core armv7hl. Packages for CentOS 6:. to handle Perl scripts with /usr/bin/perl interpreter, : install perl-interpreter package. Note: disabling bundling also disables bundling_override. Alternatively, as of version 2.24, the configuration options may be passed together with the use statement: This option causes all configuration options to be reset to their default values. If enabled, case is ignored when matching option names. perl-Complete-Getopt-Long … Just for the curiosity, after reading the next part I came back and wanted to see what happens if we supply both the --verbose and the --noverbose flags to the script. Note that this source tree contains a Makefile.PL (for Perl) and a GNUmakefile (for development). Note that, if you have options a, l and all, and auto_abbrev enabled, possible arguments and option settings are: The surprising part is that --a sets option a (due to auto completion), not all. : This subroutine produces a standard help message, derived from the program's POD section SYNOPSIS using Pod::Usage. This command will download and install the Perl package along with its dependencies from Ubuntu Repo as can be seen from below output. First unpack the kit, if you have not already done so: gzip -d < Getopt-Long-x.y.tar.gz | tar xf -, This will install Getopt/Long.pm, newgetopt.pl and the Getopt::Long, documentation. It is good practice to always specify the options first, and the other arguments last. We would like to enable a boolean flag such as--verbose, --quiet, or --debugthat just by their mere presence make an impact.Flags that don't need an additional value. We have installed perl-Getopt-Long-2.38-1.el5.rf.noarch.rpm from rpmforge base repo as late as 23 January 2012. Now, it only appears in testing as perl-Getopt-Long-2.38-1.el5.rft.noarch.rpm, but I could find no explanation as to why it was moved on the users or packagers list. The option does not take an argument and may be negated by prefixing it with "no" or "no-". I am trying to use the platform designer. When GetOptions() encounters an argument that does not look like an option, it will immediately call this subroutine and passes it one parameter: the argument name. The argument specification is optional. You cannot tie this routine directly to an option, e.g. Mageia 7.1. Command line options come in several flavours. People watching this port, also watch: p5-Digest-SHA1, libiconv, gmake, gettext, p5-HTML-Tagset. With gnu_getopt, command line handling should be reasonably compatible with GNU getopt_long(). Also, options may be placed between non-option arguments. The + form is now obsolete and strongly deprecated. For example, the command line: where each successive 'list add' option will push the value of add into array ref $list->{'add'}. This can be accomplished by adding a repeat specifier to the option specification. How do I put a "-?" The callback object has the following methods: The name of the option, unabbreviated. The Perl modules, especially GetOptions::Long, are much more powerful and flexible. cpanm. Options that are not actually used on the command line will not be put in the hash, on other words, exists($h{option}) (or defined()) can be used to test if an option was used. For detailed instructions, please see this FAQ. Getopt::Long supports two useful variants of simple options: negatable options and incremental options. It parses the command line from @ARGV, recognizing and removing specified options and their possible values. This program is Copyright 1990,2015 by Johan Vromans. Supported types are: String. Their mere presence on the command line enables the option. The contents of the string are split into arguments using a call to Text::ParseWords::shellwords. To install Getopt::Long::Descriptive, copy and paste the appropriate command in to your terminal. Default is disabled unless environment variable POSIXLY_CORRECT has been set, in which case require_order is enabled. C:\Users\sastagi\Desktop\Getopt-Long-2.42>perl Makefile.pl Set up gcc environment - 3.4.5 (mingw-vista special r3) I found left-over files from a previous version of Getopt::Long. People watching this port, also watch: p5-Digest-SHA1, libiconv, gmake, gettext, p5-HTML-Tagset. A Perl pattern that allows the disambiguation of long and short prefixes. Default is enabled unless environment variable POSIXLY_CORRECT has been set, in which case permute is disabled. About; Contributors; Linux . GetOptions() will return a true value if the command line could be processed successfully. This function implements the POSIX standard for command line options, with GNU extensions, while still capable of handling the traditional one-letter options (including option bundling). options if the application did not specify a handler for this option itself. It adheres to the POSIX syntax for command line options, with GNU extensions. This option causes all configuration options to be reset to their default values as if the environment variable POSIXLY_CORRECT had been set. The first argument is the name of the option. The repeat specifies the number of values this option takes per occurrence on the command line. If the text of the error message starts with an exclamation mark ! The Getopt::Long module implements an extended getopt function called GetOptions (). In particular, you cannot tie it directly to an option, e.g. This module is basically just a thin wrapper for Getopt::Long. To have the single-character options matched case insensitive as well, use: It goes without saying that bundling can be quite confusing. Getopt::Long will, however, allow the options and arguments to be mixed and 'filter out' all the options before passing the rest of the arguments to the program. You can also use this behaviour to get non-default commandline option names and aliases. About; Contributors; Linux. If max is omitted, but the comma is not, there is no upper bound to the number of argument values taken. Whether command line arguments are allowed to be mixed with options. Integer. Configure -S can be run non-interactively. Thecharacters of this element (aside from the initial '-') are option characters. Options can take multiple values at once, for example. Adélie Alpine ALT Linux Arch Linux CentOS Debian Fedora KaOS Mageia Mint OpenMandriva openSUSE OpenWrt PCLinuxOS Slackware Solus Ubuntu. It takes the same arguments as VersionMessage(). Untitled. GetOptions returns true to indicate success. To use Getopt::Long from a Perl program, you must include the following line in your Perl program: This will load the core of the Getopt::Long module and prepare your program for using it. As with GetOptionsFromArray, a first argument hash reference now becomes the second argument. Name : perl-Getopt-GUI-Long Version : 0.93 Vendor : Fedora Project Release : 7.fc26 Date : 2017-02-11 14:15:07 Group : Development/Libraries Source RPM : perl-Getopt-GUI-Long-0.93-7.fc26.src.rpm Size : 0.05 MB Packager : Fedora Project Summary : A wrapper around Getopt::Long … Normally, a lone dash - on the command line will not be considered an option. The string that starts options. Let’s imagine I wanted to create a program for creating software licenses, like App::Software::License. For each option that is specified on the command line, the option value will be stored in the hash with the option name as key. If an option that starts with '-' (not "--") doesn't match a long option, but does match a short option, it is parsed as a short option instead. Without gnu_compat, --opt= gives an error. For example, a program could do its job quietly, but with a suitable option it could provide verbose information about what it did. Getopt::Long - Extended processing of command line options. You have chosen search in content of rpms. The GetOptions fun… A reference to a filehandle, or the pathname of a file to which the usage message should be written. Otherwise, it will write error messages using die() and warn(), and return a false result. Cannot retrieve contributors at this time. pkgs.org. Note: disabling bundling_override also disables bundling. Ultimate control over what should be done when (actually: each time) an option is encountered on the command line can be achieved by designating a reference to a subroutine (or an anonymous subroutine) as the option destination. Supported option syntax includes: Subject: Re: Getopt::Long, + options, installperl, +v It should be omitted when not needed. For older, versions of Perl, it can be fetched from CPAN. README.posix-bc has been renamed to README.bs2000. But before, be sure that you have the getopt installed correctly : $ sudo apt install libgetopt-simple-perl Then go to … Packages for openSUSE Leap 15.2:. CentOS AppStream aarch64 Official perl-Getopt-Long-2.51-1.module_el8.3.0+406+78614513.noarch.rpm: Extended processing of command line options: perl-Getopt-Long-2.49.1-3.module_el8.1.0+229+cd132df8.noarch.rpm The value will be stored with the specified key in the hash. This should be an integer, or else the string "NOEXIT" to indicate that control should simply be returned without terminating the invoking process. Extended integer, Perl style. it is interpreted specially by GetOptions(). For options that take list or hash values, it is necessary to indicate this by appending an @ or % sign after the type: To make things more complicated, the hash may contain references to the actual destinations, for example: Any mixture is possible. This call will allow --l and --L for the length option, but requires a least --hea and --hei for the head and height options. See the GNU General Public License for more details. In the default configuration, options names may be abbreviated to uniqueness, case does not matter, and a single dash is sufficient, even for long option names. These errors are signalled using warn() and can be trapped with $SIG{__WARN__}. perl-Getopt-Long-2.52-lp152.1.1.noarch.rpm perl-Getopt-Long-2.52-lp152.1.1.src.rpm The result would be like. Warning: What follows is an experimental feature. As with GetOptionsFromArray, the global @ARGV is not touched. FreeBSD NetBSD. The earliest development of newgetopt.pl started in 1990, with Perl version 4. An element of argv that starts with '-' (and is not exactly "-" or "--") is an option element. Once Server is updated you can now install the Perl package using apt install perl -y command as shown below. By default, attributes beginning with an underscore are considered private and are not given commandline argument support, unless the attribute's metaclass is set to MooseX::Getopt::Meta::Attribute. [/usr/bin/perl] Net::SNMP module version is v6.0.1 [OK] Module Getopt::Long found [OK] What is your monitoring plugin location ? Perl's Getopt::Long allows a developer to add their own options to a script. Perl 1.0 was released in 1987, and at the time of writing this article on Steps to Install Perl on RedHat/CentOS 7, I am using version 5.16. Step 3: Install Perl on Ubuntu 20.04. A negatable option is specified with an exclamation mark ! I start by importing Getopt::Long, it’s part of the core Perl distribution, so if you have Perl installed, you should already have it.The GetOptions function from Getopt::Long is where the magic happens. When generating a Qsys project, I get the following error: Why was this changed? A special entry GetOptionsFromArray can be used to parse options from an arbitrary array. CentOS 8. C++ | 25 min ago . As a quick introduction, a couple of years ago I wrote a Unix command named Teleport, which is an improvement on the Unix cd command. It defaults to 1 for options with = and to 0 for options with :, see below. For a hash destination, the second argument is the key to the hash, and the third argument the value to be stored. To distinguish bundles from long option names, long options (and any of their auto-abbreviated shortened forms) must be introduced with -- and bundles with -. To stop Getopt::Long from processing further arguments, insert a double dash -- on the command line: In this example, --all will not be treated as an option, but passed to the program unharmed, in @ARGV. The name of the option as actually used, unabbreveated. For example, each occurrence of --verbose could increase the verbosity level of the program. Option processing will terminate (unless "permute" is configured) and the dash will be left in @ARGV. How to install Getopt-Long. http://search.cpan.org/search?dist=Pod-Parser. osx-64 v2.50. Type ppm install Getopt-Long-Subcommand Perl 5.8 Perl 5.10 Perl 5.12 Perl 5.14 Perl 5.16 Perl 5.18 Perl 5.20 Perl 5.22 Perl 5.24; Windows (32-bit) n/a n/a n/a 0.05 0.103: Never Built: Why not? Support for bundling of command line options, as was the case with the more traditional single-letter approach, is provided but not enabled by default. If omitted, an empty string will be assigned to string values options, and the value zero to numeric options. It is also possible to specify the minimal and maximal number of arguments an option takes. Note that permute is the opposite of require_order. This makes it possible to write wrapper scripts that process only part of the user supplied command line arguments, and pass the remaining options to some other program. The Pod::Usage, module is part of standard Perl as of Perl version 5.6. Multiple calls to Configure() are possible. Getopt::Long encourages the use of Pod::Usage to produce help messages. Typically you only need to set this if you are using nonstandard prefixes and want some or all of them to have the same semantics as '--' does under normal circumstances. Display 1 - 40 hits of 1295. Using a suitable default value, the program can find out whether $verbose is false by default, or disabled by using --noverbose. This module also supports single-character options and bundling. Each option specifier consists of two parts: the name specification and the argument specification. gnu_compat controls whether --opt= is allowed, and what it should do. If the option value is required, Getopt::Long will take the command line argument that follows the option and assign this to the option variable. Module Getopt::Long implements an extended getopt function called GetOptions(). The variable optind is the index of the next element to be … It can be enabled with: In all of the above cases, option values may be inserted in the bundle. The object stringifies to the option name so this change should not introduce compatibility problems. Version 2.33 of module Getopt::Long has been released to CPAN. Download perl-Complete-Getopt-Long-0.46-alt1.noarch.rpm for ALT Linux P9 from Autoimports repository. Allow + to start options. A Perl pattern that identifies the strings that introduce options. Using a colon : instead of the equals sign indicates that the option value is optional. Well, using a starter argument is strongly deprecated anyway. Also, option values could be specified either like. An incremental option is specified with a plus + after the option name: Using --verbose on the command line will increment the value of $verbose. It is up to the subroutine to store the value, or do whatever it thinks is appropriate. This way the program can keep track of how many times the option occurred on the command line. This is the way GNU getopt_long() does it. Real number. It is not thread safe when using the older (experimental and now obsolete) threads implementation that was added to Perl 5.005. Settings. Can't locate Getopt/Long.pm when generating a Qsys Project Quartus 19.1 has issues with its perl distribution on Linux. Apparently, the module is not installed for Intel embedded perl. For more information on module installation, please visit the detailed CPAN module installation guide. But it is also allowed to use --noverbose, which will disable $verbose by setting its value to 0. To install Getopt::Long, copy and paste the appropriate command in to your terminal. When GetOptions() encounters the option, it will call the subroutine with two or three arguments. To use Getopt::Long from a Perl program, you must include the following line in your Perl program: use Getopt::Long; This will load the core of the Getopt::Long module and prepare your program for using it. Besides, it is much easier. Default is --|-|\+ unless environment variable POSIXLY_CORRECT has been set, in which case it is --|-.