File: set_mode.3m_cli2.html

package info (click to toggle)
fortran-cli2 3.2.0-4
links: PTS, VCS
area: main
in suites: forky, sid
size: 25,856 kB
sloc: f90: 6,172; javascript: 3,423; makefile: 189; sh: 25
file content (211 lines) | stat: -rw-r--r-- 6,374 bytes
<html> 
<head> 
<title> </title>
<style> 
px {font-family: "Lucida Console", Monaco, monospace }
p { font-size:100%; line-height:1.1em; }
body {xfont-style: sans-serif}
body {
color:#333; font-family:Verdana, Arial, Helvetica, sans-serif; font-size:1em; line-height:1.3em; }
a:visited { color:#666; }
h1,h2,h3,h4,h5,h6 { color:#333; font-family:georgia, verdana, sans-serif; }
h1 { font-size:150%; page-break-before:auto;background-color: #aaaaff}
h2 { font-size:143%;color:teal; }
h3 { font-size:134%;color:blue; }
h4 { font-size:120%;color:gray; }
img { max-width: 55em}
p{ padding: 0;margin:0; }
p{ padding-right:1.4em; }
p{ padding-bottom:0.1em; }
p{ padding-top:1em; }
p{ whitespace: pre-wrap; }
h5,h6 { font-size:100% }
a.nav,a:link.nav, a:visited.nav { background-color:#FFF; color:#000; }
XXtable { border:double #000; border-collapse:collapse; }
XXtable { border-collapse:collapse; }
XXtd { border:thin solid #888; }
XXtd { border:none; }
li { margin-bottom:0.5em; }
blockquote { display:block; font-size:100%; line-height:1.1em; margin:0 0 0.5em; padding:0 2.5em; }
pre { background-color:#DDD; font-size:100%; overflow:auto; padding:1em; }
a,li span { color:#000; }
a:hover, a.nav:hover, a:hover math { background-color:#000; color:#FFF; }
#Container { margin:0 10px; text-align:center; background-color: #BBB}
#Content { border-top:none; margin:auto; padding:0.3em; text-align:left; width:100%; max-width:55em; background:#FFF}
span.webName { font-size:.5em; }
textarea#content { font-size: 1em; line-height: 1.125; }
h1#pageName { line-height:1em; margin:0.2em 0 0.2em 0; padding:0; }
.property { color:#666; font-size:100%; }
a.existingWikiWord[title]{ //border: 1px dashed #BBB; }
.byline { color:#666; font-size:1.0em; font-style:italic; margin-bottom:1em; padding-top:1px; } 
</style> 
</head>
<BODY bgcolor=#F0F0F0 text=#000000 link=#0000ff vlink=#C000C0 alink=#ff0000><A NAME=top></A>
<!--
<h5><a href="https://github.com/urbanjost/M_CLI2">[UP]</a></h5>
<button type="button" onclick="javascript:history.back()">Back</button>
-->
<div id="Container">
<div id="Content">
<CENTER>
<H1><HR><I>Manual Reference Pages &nbsp;-&nbsp;</I><NOBR>set_mode (3m_cli2)</NOBR><HR></H1>
</CENTER>
<A name=0>

     <H3>NAME</H3>

</A>
<BLOCKQUOTE>
set_mode(3f) - [ARGUMENTS:M_CLI2] turn on optional modes
(LICENSE:PD)
<P>
</BLOCKQUOTE>
<A name=contents></A><H3>CONTENTS</H3></A>
<BLOCKQUOTE>
<A HREF=#1>Synopsis</A><BR>
<A HREF=#2>Description</A><BR>
<A HREF=#3>Options</A><BR>
<A HREF=#4>Example</A><BR>
<A HREF=#5>Author</A><BR>
<A HREF=#6>License</A><BR>
</BLOCKQUOTE>
<A name=7>

     <H3>SYNOPSIS</H3>

</A>
<BLOCKQUOTE>
subroutine set_mode(key,mode)
<P>
<PRE>
    character(len=*),intent(in) :: key
    logical,intent(in),optional :: mode
<P>
</PRE>
</BLOCKQUOTE>
<A name=2>

     <H3>DESCRIPTION</H3>

</A>
<BLOCKQUOTE>
Allow optional behaviors.
</BLOCKQUOTE>
<A name=3>

     <H3>OPTIONS</H3>

</A>
<BLOCKQUOTE>
<TABLE cellpadding=3>
<TR valign=top><TD width=6% nowrap>
<B>KEY</B> </TD><TD valign=bottom>
name of option
</TD></TR>
<TR><TD colspan=2>
The following values are allowed:
</TD></TR>
<TR></TR></TABLE><TABLE cellpadding=3>
<TR valign=top><TD width=3%>
o
</TD><TD>
response_file - enable use of response file
</TD></TR>
<TR valign=top><TD width=3%>
o
</TD><TD>
ignorecase - ignore case in long key names. So the user
does not have to remember if the option is <B>--IgnoreCase</B>
or <B>--ignorecase</B> or <B>--ignoreCase</B>
</TD></TR>
<TR valign=top><TD width=3%>
o
</TD><TD>
underdash - treat dash in keyword as an underscore.
So the user should not have to remember if the option is
<B>--ignore_case</B> or <B>--ignore-case</B>.
</TD></TR>
<TR valign=top><TD width=3%>
o
</TD><TD>
strict - allow Boolean keys to be bundled, but requires
a single dash prefix be used for short key names and
long names must be prefixed with two dashes.
</TD></TR>
<TR valign=top><TD width=3%>
o
</TD><TD>
lastonly - when multiple keywords occur keep the rightmost
value specified instead of appending the values together.
</TD></TR>
<TR valign=top><TD colspan=2>
<B>MODE</B> </TD></TR><TR valign=top><TD width=3%>&nbsp;</TD><TD>
set to .true. to activate the optional mode.
Set to .false. to deactivate the mode.
It is .true. by default.
</TD></TR>
<TR></TR></TABLE></BLOCKQUOTE>
<A name=4>

     <H3>EXAMPLE</H3>

</A>
<BLOCKQUOTE>
Sample program:
<P>
<PRE>
   program demo_set_mode
   use M_CLI2,  only : set_args, lget, set_mode
   implicit none
   character(len=*),parameter :: all=&#146;(*(g0))&#146;
      !
      ! enable use of response files
      call set_mode(&#146;response_file&#146;)
      !
      ! Any dash in a keyword is treated as an underscore
      call set_mode(&#146;underdash&#146;)
      !
      ! The case of long keywords are ignored.
      ! Values and short names remain case-sensitive
      call set_mode(&#146;ignorecase&#146;)
      !
      ! short single-character boolean keys may be bundled
      ! but it is required that a single dash is used for
      ! short keys and a double dash for long keywords.
      call set_mode(&#146;strict&#146;)
      !
      call set_args(&#146; --switch_X:X F --switch-Y:Y F --ox:O F -t F -x F -o F&#146;)
      !
      print all,&#146;--switch_X or -X &#46;&#46;&#46; &#146;,lget(&#146;switch_X&#146;)
      print all,&#146;--switch_Y or -Y &#46;&#46;&#46; &#146;,lget(&#146;switch_Y&#146;)
      print all,&#146;--ox or -O       &#46;&#46;&#46; &#146;,lget(&#146;ox&#146;)
      print all,&#146;-o               &#46;&#46;&#46; &#146;,lget(&#146;o&#146;)
      print all,&#146;-x               &#46;&#46;&#46; &#146;,lget(&#146;x&#146;)
      print all,&#146;-t               &#46;&#46;&#46; &#146;,lget(&#146;t&#146;)
   end program demo_set_mode
<P>
</PRE>
</BLOCKQUOTE>
<A name=5>

     <H3>AUTHOR</H3>

</A>
<BLOCKQUOTE>
John S. Urban, 2019
</BLOCKQUOTE>
<A name=6>

     <H3>LICENSE</H3>

</A>
<BLOCKQUOTE>
Public Domain
</BLOCKQUOTE>
<P><HR>
<TABLE width=100%><TR> <TD width=33%><I>Nemo Release 3.1</I></TD> <TD width=33% align=center>set_mode (3m_cli2)</TD> <TD align=right width=33%><I>February 10, 2023</I></TD> </TR></TABLE><FONT SIZE=-1>Generated by <A HREF="http://www.squarebox.co.uk/download/manServer.shtml">manServer 1.08</A> from 0bf00e61-4940-4fdb-be00-aa744c4cd778 using man macros.</FONT>
<br><br><center><img src="images/set_mode.gif"></center>
</div>
</div>
</body>
</HTML>