Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
STYLE(1)			 User commands			      STYLE(1)

NAME
       style - analyse surface characteristics of a document

SYNOPSIS
       style [-L language] [-l length] [-r ari]	[file...]
       style [--language language] [--print-long length] [--print-ari ari]
       [file...]
       style -h|--help
       style --version

DESCRIPTION
       Style analyses the surface characteristics of the writing  style	 of  a
       document.   It prints various readability grades, length	of words, sen-
       tences and paragraphs.  It can further locate  sentences	 with  certain
       characteristics.	  If  no  files	 are  given, the document is read from
       standard	input.

       Numbers are counted as words  with  one	syllable.   A  sentence	 is  a
       sequence	 of words, that	starts with a capitalised word and ends	with a
       full stop, double colon,	question mark or exclamation mark.   A	single
       letter  followed	by a dot is considered an abbreviation,	so it does not
       end a sentence.	Various	 multi-letter  abbreviations  are  recognized,
       they  do	 not  end  a sentence as well.	A paragraph consists of	two or
       more new	line characters.

   Readability grades
       Style understands cpp(1)	#line lines for	being  able  to	 give  precise
       locations when printing sentences.

       Kincaid formula
	      The  Kincaid  Formula has	been developed for Navy	training manu-
	      als, that	ranged in difficulty from 5.5 to 16.3.	It is probably
	      best  applied  to	 technical  documents,	because	it is based on
	      adult training manuals rather than school	 book  text.   Dialogs
	      (often  found  in	fictional texts) are usually a series of short
	      sentences, which lowers the score.  On the  other	 hand,	scien-
	      tific  texts  with  many long scientific terms are rated higher,
	      although they are	not necessarily	harder to read for people  who
	      are familiar with	those terms.

	      Kincaid =	11.8*syllables/wds+0.39*wds/sentences-15.59

       Automated Readability Index
	      The Automated Readability	Index is typically higher than Kincaid
	      and Coleman-Liau,	but lower than Flesch.

	      ARI = 4.71*chars/wds+0.5*wds/sentences-21.43

       Coleman-Liau Formula
	      The Coleman-Liau Formula usually gives a lower grade  than  Kin-
	      caid, ARI	and Flesch when	applied	to technical documents.

	      Coleman-Liau = 5.88*chars/wds-29.5*sent/wds-15.8

       Flesh reading easy formula
	      The  Flesh  reading  easy	formula	has been developed by Flesh in
	      1948 and it is based on school text covering grade 3 to 12.   It
	      is  wide	spread,	especially in the USA, because of good results
	      and simple computation.  The index is usually between  0	(hard)
	      and  100	(easy),	 standard  English documents averages approxi-
	      mately 60	to 70.	Applying  it  to  German  documents  does  not
	      deliver  good  results  because of the different language	struc-
	      ture.

	      Flesch Index = 206.835-84.6*syll/wds-1.015*wds/sent

       Fog Index
	      The Fog index has	been developed by Robert Gunning.   Its	 value
	      is  a school grade.  The ``ideal'' Fog Index level is 7 or 8.  A
	      level above 12 indicates the writing sample is too hard for most
	      people  to read.	Only use it on texts of	at least hundred words
	      to get meaningful	results.  Note that a  correct	implementation
	      would not	count words of three or	more syllables that are	proper
	      names, combinations of easy words, or made  three	 syllables  by
	      suffixes such as -ed, -es, or -ing.

	      Fog Index	= 0.4*(wds/sent+100*((wds >= 3 syll)/wds))

       Lix formula
	      The  Lix formula developed by Bjornsson from Sweden is very sim-
	      ple and employs a	mapping	table as well:

	      Lix = wds/sent+100*(wds >= 6 char)/wds

	      Index	    34	 38   41   44	48   51	   54	 57
	      School year      5    6	 7    8	   9	10    11

       SMOG-Grading
	      The  SMOG-Grading	 for  English  texts  has  been	 developed  by
	      McLaughlin in 1969.  Its result is a school grade.

	      SMOG-Grading = square root of (((wds >= 3	syll)/sent)*30)	+ 3

	      It  has  been  adapted to	German by Bamberger & Vanecek in 1984,
	      who changed the constant +3 to -2.

   Word	usage
       The word	usage counts are intended to help identify  excessive  use  of
       particular parts	of speech.

       Verb Phrases
	      The  category  of	verbs labeled "to be" identifies phrases using
	      the passive voice.  Use the passive voice	sparingly, in favor of
	      more  direct  verb  forms.  The flag -p causes style to list all
	      occurrences of the passive voice.

       The verb	category "aux" measures	the use	of modal auxiliary verbs, such
       as "can", "could", and "should".	 Modal auxiliary verbs modify the mood
       of a verb.

       Conjunctions
	      The conjunctions counted by style	are coordinating and  subordi-
	      nating.  Coordinating conjunctions join grammatically equal sen-
	      tence fragments, such as a noun with a noun,  a  phrase  with  a
	      phrase,  or a clause to a	clause.	 Coordinating conjunctions are
	      "and," "but," "or," "yet," and "nor."

       Subordinating conjunctions connect clauses of unequal status.  A	subor-
       dinating	 conjunction  links  a	subordinate clause, which is unable to
       stand alone, to an independent clause.  Examples	of subordinating  con-
       junctions are "because,"	"although," and	"even if."

       Pronouns
	      Pronouns	are  contextual	 references to nouns and noun phrases.
	      Documents	with few pronouns generally lack cohesiveness and flu-
	      idity.  Too many pronouns	may indicate ambiguity.

       Nominalizations
	      Nominalizations are verbs	that are changed to nouns.  Style rec-
	      ognizes words that end in	"ment,"	"ance,"	"ence,"	 or  "ion"  as
	      nominalizations.	 Examples  are	"endowment," "admittance," and
	      "nominalization."	 Too much nominalization  in  a	 document  can
	      sound  abstract  and  be	difficult  to understand.  The flag -N
	      causes style to list all nominalizations.	 The  flag  -n	prints
	      all sentences with either	the passive voice or a nominalization.

OPTIONS
       -L language, --language language
	      set the document language	(de, en, nl).

       -l length, --print-long length
	      print all	sentences longer than length words.

       -r ari, --print-ari ari
	      print  all  sentences  whose  readability	index (ARI) is greater
	      than ari.

       -p passive, --print-passive
	      print all	sentences phrased in the passive voice.

       -N nominalizations, --print-nom
	      print all	sentences containing nominalizations.

       -n nominalizations-passive, --print-nom-passive
	      print all	sentences  phrased in the passive voice	or  containing
	      nominalizations.

       -h, --help
	      Print a short usage message.

       --version
	      Print the	version.

ERRORS
       On  usage  errors, 1 is returned.  Termination caused by	lack of	memory
       is signalled by exit code 2.

ENVIRONMENT
       LC_MESSAGES=de|en|nl
	      specifies	the default document language.	The  default  language
	      is en.

       LC_CTYPE=iso-8859-1
	      specifies	the document character set.  The default character set
	      is ASCII.

AUTHOR
       This program  is	 GNU  software,	 copyright  1997-2007  Michael	Haardt
       <michael@moria.de>.

       It  contains  contributions  by Jason Petrone <jpetrone@acm.org>, Uschi
       Stegemeier <uschi@morwain.de> and Hans Lodder.

       This program is free software; you can redistribute it and/or modify it
       under  the  terms of the	GNU General Public License as published	by the
       Free Software Foundation; either	version	3 of the License, or (at  your
       option) any later version.

       This  program  is  distributed  in the hope that	it will	be useful, but
       WITHOUT ANY  WARRANTY;  without	even  the  implied  warranty  of  MER-
       CHANTABILITY  or	FITNESS	FOR A PARTICULAR PURPOSE.  See the GNU General
       Public License for more details.

       You should have received	a copy of the GNU General Public License along
       with  this  program.   If  not,	write to the Free Software Foundation,
       Inc., 59	Temple Place - Suite 330, Boston, MA 02111-1307, USA.

HISTORY
       There has been a	style command on old UNIX systems, which is  now  part
       of  the	AT&T  DWB  package.  The original version was bound to roff by
       enforcing a call	to deroff.

SEE ALSO
       deroff(1), diction(1)

       Cherry, L.L.; Vesterman,	W.: Writing Tools--The STYLE and DICTION  pro-
       grams,  Computer	Science	Technical Report 91, Bell Laboratories,	Murray
       Hill, N.J. (1981), republished as part of the 4.4BSD User's  Supplemen-
       tary Documents by O'Reilly.

       Coleman,	 M.  and  Liau,T.L.  (1975).  'A  computer readability formula
       designed	for machine scoring', Journal of  Applied  Psychology,	60(2),
       283-284.

GNU			       August 30th, 2007		      STYLE(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | ERRORS | ENVIRONMENT | AUTHOR | HISTORY | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=style&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help