From owner-freebsd-questions@FreeBSD.ORG Fri Nov 7 05:58:48 2008 Return-Path: Delivered-To: freebsd-questions@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 644B51065672 for ; Fri, 7 Nov 2008 05:58:48 +0000 (UTC) (envelope-from keramida@freebsd.org) Received: from igloo.linux.gr (igloo.linux.gr [62.1.205.36]) by mx1.freebsd.org (Postfix) with ESMTP id BB4DF8FC18 for ; Fri, 7 Nov 2008 05:58:47 +0000 (UTC) (envelope-from keramida@freebsd.org) Received: from kobe.laptop (adsl202-73.kln.forthnet.gr [79.103.15.73]) (authenticated bits=128) by igloo.linux.gr (8.14.3/8.14.3/Debian-5) with ESMTP id mA75wbFj010984 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Fri, 7 Nov 2008 07:58:42 +0200 Received: from kobe.laptop (kobe.laptop [127.0.0.1]) by kobe.laptop (8.14.3/8.14.3) with ESMTP id mA75wbV7012204; Fri, 7 Nov 2008 07:58:37 +0200 (EET) (envelope-from keramida@freebsd.org) Received: (from keramida@localhost) by kobe.laptop (8.14.3/8.14.3/Submit) id mA75wb05012203; Fri, 7 Nov 2008 07:58:37 +0200 (EET) (envelope-from keramida@freebsd.org) From: Giorgos Keramidas To: Eitan Adler References: <4913C74C.80606@gmail.com> Date: Fri, 07 Nov 2008 07:58:36 +0200 In-Reply-To: <4913C74C.80606@gmail.com> (Eitan Adler's message of "Thu, 06 Nov 2008 23:42:52 -0500") Message-ID: <87d4h884c3.fsf@kobe.laptop> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.60 (berkeley-unix) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-MailScanner-ID: mA75wbFj010984 X-Hellug-MailScanner: Found to be clean X-Hellug-MailScanner-SpamCheck: not spam, SpamAssassin (not cached, score=-4.072, required 5, autolearn=not spam, ALL_TRUSTED -1.80, AWL 0.33, BAYES_00 -2.60) X-Hellug-MailScanner-From: keramida@freebsd.org X-Spam-Status: No Cc: freebsd-doc@freebsd.org, freebsd-questions@freebsd.org Subject: Re: spell check - how to? X-BeenThere: freebsd-questions@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: User questions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 07 Nov 2008 05:58:48 -0000 On Thu, 06 Nov 2008 23:42:52 -0500, Eitan Adler wrote: > [cc to -questions as it might be a general question] Hi Eitan :-) > I'm looking to do a full spell check/fix on the handbook. I found > "make spellcheck-txt" which apparently removed certain items that > would not go well through a spell checker - however I don't know how > to actually run the spellcheck itself. > > I have aspell installed. You will probably have to tweak the ISPELLOPTS to use aspell. The current spellcheck targets use a default ISPELLOPTS with a value of: %%% doc/el/share/mk/doc.project.mk:ISPELL?= ispell doc/el/share/mk/doc.project.mk:ISPELLOPTS?= -l -p /usr/share/dict/freebsd ${ISPELLFLAGS} %%% The -l option is not supported by aspell, so the following spellcheck run fails: : % pwd : /ws/doc/en_US.ISO8859-1/articles/contributing : % env ISPELL=aspell make FORMATS=txt spellcheck : Spellcheck article.txt : Error: You must specify a parameter for "-l". : *** Error code 1 : But you can set ISPELL and ISPELLOPTS in the runtime environment to pass aspell-compatible options: : % env ISPELL=aspell ISPELLOPTS='list' make FORMATS=txt spellcheck : Spellcheck article.txt : jcamou : IEEE : ... Unfortunately, the wordlist at `/usr/share/dict/freebsd' is not usable with aspell right now, so if you try to use it you will get errors like: : env ISPELL=aspell \ : ISPELLOPTS='-p /usr/share/dict/freebsd ${ISPELLFLAGS}' \ : ISPELLFLAGS='list' make FORMATS=txt spellcheck : Spellcheck article.txt : Error: The file "/usr/share/dict/freebsd" is not in the proper format. : *** Error code 1 The main drawback of being unable to use the `freebsd' wordlist is that you will get many false positives for words that are perfectly valid for FreeBSD documentation but are not standard English words.