User Commands - flower (1)

NAME

flower(1f) - [DEVELOPER] change case of free-format Fortran file or remove code or remove comments (LICENSE:PD)

Synopsis
Description
Options
Examples
Exit Status

SYNOPSIS

flower [ --stat|[ [--nocomment|--nocode] [--toupper]|[--verbose] ] FILENAMES(s) ]|[--help|--version|--usage]

DESCRIPTION

flower(1) depends on the input being plain standard free-format Fortran so the output should be carefully checked.

1. flower(1) will convert free-format Fortran code to lowercase. It can also convert the code to uppercase. In each case comments and quoted text are left as-is.

2. flower(3f) can additionally generate simple statistics about what percentage of the code is comments.

3. flower(1) can strip comments from the code.

4. Alternatively, the code can be removed so the comments can be used for documentation or run through utilities like spell checkers.

This is a basic program that writes its results to stdout and does not recognize Hollerith strings and preprocessor directives as special cases.
Tabs should be expanded before processing the file.

OPTIONS

FILENAME
Fortran source file which is to be converted to lowercase

--nocomment
remove comment characters

--nocode
remove code characters

--toupper
convert code characters to uppercase instead of lowercase

--verbose
turn on verbose mode including file statistics. Note that if --nocomment and --nocode are selected --verbose is implied.

--stat is the same as --nocomment --nocode --verbose, meaning no other output than file statistics will be produced. If present, --nocomment, --nocode, and --verbose are ignored.

--help display help text and exit

--version
display version text and exit

EXAMPLES

Typical usage

# convert all code to lowercase flower sample.f90 > sample_new.f90

# show stats for files measuring percent of comments flower --stat *.f90 *.F90

# check spelling on comments flower --nocode *.f90 *.F90|spell

# grep code ignoring comments flower --nocomment *.f90 *.F90|grep -iw contains

EXIT STATUS

The following exit values are returned:

0 no differences were found

1 differences were found

Nemo Release 3.1

flower (1)

February 23, 2025

Generated by manServer 1.08 from 20db2b69-ac40-4415-84c6-fd4a317c04da using man macros.

1.	flower(1) will convert free-format Fortran code to lowercase. It can also convert the code to uppercase. In each case comments and quoted text are left as-is.
2.	flower(3f) can additionally generate simple statistics about what percentage of the code is comments.
3.	flower(1) can strip comments from the code.
4.	Alternatively, the code can be removed so the comments can be used for documentation or run through utilities like spell checkers.

FILENAME
	Fortran source file which is to be converted to lowercase
--nocomment
	remove comment characters
--nocode
	remove code characters
--toupper
	convert code characters to uppercase instead of lowercase
--verbose
	turn on verbose mode including file statistics. Note that if --nocomment and --nocode are selected --verbose is implied.
--stat	is the same as --nocomment --nocode --verbose, meaning no other output than file statistics will be produced. If present, --nocomment, --nocode, and --verbose are ignored.
--help	display help text and exit
--version
	display version text and exit