From owner-freebsd-doc@freebsd.org Thu Apr 28 22:06:06 2016 Return-Path: Delivered-To: freebsd-doc@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id BE2ECB20BDB for ; Thu, 28 Apr 2016 22:06:06 +0000 (UTC) (envelope-from pfg@FreeBSD.org) Received: from nm42-vm5.bullet.mail.bf1.yahoo.com (nm42-vm5.bullet.mail.bf1.yahoo.com [216.109.114.204]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 71EE51133 for ; Thu, 28 Apr 2016 22:06:06 +0000 (UTC) (envelope-from pfg@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048; t=1461881159; bh=8gLRjFT5/qVfqtSErAqxdgwxajswVmpt/uE6bzPMO/4=; h=Subject:To:References:Cc:From:Date:In-Reply-To:From:Subject; b=fakw3zsxTYIQaOZcH4sWHoIhmqrZHIidUGQtDtlWWTjtZ8Hj79a0ZADA3vLroFY4t7CSRuGFB/tD7QLaSLPHpLXb3Yikd23OZY3dXMm/CS0CuVXyK0pcjcHNpTAHua4RGzJQLbSi9x3kNwTwvdk5GISngNV30SHD5vlY910RJM1InvS1hTBFAvrzkCJ0uKtlzOzkZiWID5JVpcpOugYfQmd+xJLkyf6adiBxjDzPFbF1E5fU925q3Jp+8c7nPconb+y1h7IX99EYx8eeVEmJrcEGk+kOGrAdQ3MbCu5h5uORvMCvG4jncS8cW+5wtPTG0xxwWoHjZUuwnfwTDhNgJg== Received: from [66.196.81.171] by nm42.bullet.mail.bf1.yahoo.com with NNFMP; 28 Apr 2016 22:05:59 -0000 Received: from [68.142.230.65] by tm17.bullet.mail.bf1.yahoo.com with NNFMP; 28 Apr 2016 22:05:59 -0000 Received: from [127.0.0.1] by smtp222.mail.bf1.yahoo.com with NNFMP; 28 Apr 2016 22:05:59 -0000 X-Yahoo-Newman-Id: 499209.82481.bm@smtp222.mail.bf1.yahoo.com X-Yahoo-Newman-Property: ymail-3 X-YMail-OSG: nYSG_.sVM1ml_1uW3cdkGKZBOVBE2XIX_l1qL5o.f25x3G0 lzxL7FZ3lLGiQRKr.6z369_.RZzKVNRIrBIIXJtfXBb_AstRDtKsXL12xja1 jipQ2fA7ZEJlJ25gpUHD9Z_EzLQ1rvjmKY7bmUZHxbRKt5LtAgVa3FlXC8D1 yGHPKNUi5V6599tSj.lqmbKjgu5Ku.i5U3Zkl0hHNhsAG.PRTKBB_6zuaSwM Kxu8vtlAJ.5zBGfmd9SCmz6HoA3RgrNzfbrictTNAyj_jw8A5u5rXOkQQC5k fPkEE4w49HENnfzhth0yA40Tm_fI0LJrQlIPq0yCE8qyq1.qnJJiD5Agyts9 lZRR7AhLLBtBc3G7iV7vYThmBWNAmQZhLqvkVGh.NJX_LKa0lrEdV1.aLVWI bWgjLo75Z9AX2DpA6.yLiLo1VhomDxQVcF275Nb2jxDfJOjJISw8DoBiIRcX VAnFrokX49KND0Rj7sEWjs2zGS4ASods1Y6o2BlPhrsCPuVU_6In_DtehQJ. adG3bGyeOpozmiKMvPJYft3_lIpycHBdi X-Yahoo-SMTP: xcjD0guswBAZaPPIbxpWwLcp9Unf Subject: Re: Where did we lurn to spel? To: Warren Block References: <5ac139d2-a9ed-e7bf-081b-2e841f4be22a@FreeBSD.org> Cc: FreeBSD-doc@FreeBSD.org From: Pedro Giffuni Message-ID: <8bfec353-748c-68e2-ddad-fd9a79790b97@FreeBSD.org> Date: Thu, 28 Apr 2016 17:06:16 -0500 User-Agent: Mozilla/5.0 (X11; FreeBSD amd64; rv:45.0) Gecko/20100101 Thunderbird/45.0 MIME-Version: 1.0 In-Reply-To: Content-Type: text/plain; charset=windows-1252; format=flowed Content-Transfer-Encoding: 7bit X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 28 Apr 2016 22:06:06 -0000 On 04/28/16 16:36, Warren Block wrote: > On Thu, 28 Apr 2016, Warren Block wrote: > >> On Thu, 28 Apr 2016, Pedro Giffuni wrote: >> >>> Hello; >>> >>> I just updated locally the textproc/codespell to the latest version >>> (bugzilla 209128 for the curious), and it finds a *crazy* amount of >>> issues in code comments. >>> >>> I can't handle it on my own, indeed I got tired just be checking >>> sys/arm ! Anyways, here is what I went "thru": >>> >>> https://people.freebsd.org/~pfg/patches/codespell/ >> >> textproc/igor finds many mistakes, and works on text files, man pages, >> DocBook, and HTML. Use of either of these tools is optional, though. >> >> Note: in sys/arm/at91/if_atereg.h, it missed "deines"->"defines". > Yes, I haven't really reviewed them beyond the initial replacement. The changes kept growing and growing and I had to stop. > Oh, and many of these are contractions, which should be avoided anyway. Well the main questions are ... 1) Should someone brave just go ahead and commit massively such cleanups? 2) Is there a clever review process to go through these? Phabricator with documentation team, or assume common sense? 3) There are many common issues: is "thru" something we should accept in comments. How about dont vs don't ? Pedro.