From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from list by lists.gnu.org with archive (Exim 4.71) id 1VlMG8-000144-Lt for mharc-grub-devel@gnu.org; Tue, 26 Nov 2013 12:17:12 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:56407) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VlMFy-00010x-Fn for grub-devel@gnu.org; Tue, 26 Nov 2013 12:17:10 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VlMFq-0004ev-2C for grub-devel@gnu.org; Tue, 26 Nov 2013 12:17:02 -0500 Received: from mail-yh0-x22e.google.com ([2607:f8b0:4002:c01::22e]:60961) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VlMFp-0004eH-U7 for grub-devel@gnu.org; Tue, 26 Nov 2013 12:16:53 -0500 Received: by mail-yh0-f46.google.com with SMTP id l109so4138936yhq.19 for ; Tue, 26 Nov 2013 09:16:53 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=message-id:date:from:user-agent:mime-version:to:subject:references :in-reply-to:content-type:content-transfer-encoding; bh=9OF8ITqeZ9vDGwXJ1SNySw230BNSzHspqufXXyfWSiY=; b=CQMwev+pU1+3s+NDbF40Pqo0TMY7h5oXZ5Rg14ktSxJFmBFXldEvKHvFtW/uXHfRLO ZfiF19r1TsyLEoMUZsYNbWru6dnzMe+I8A50EBrp9FWyFmyT35iX4DVJDg32ay7OksmF V1CNSHpix7yvR5GFQQJpVaYOpd2GYjvHs3/k6OVI8ua+7lQZ9g8MDzH7uUY/UT5+Img2 Tj15bEypC1E1QO8IxxImS/1CCasxK2K5+IXsk686upqCAbklBLnVj2Fi4zbBLLx5MpCf 0mI/250ROjo6e62dm6ld4ZFhLM9jRepQLGfySzY1BosybzE16qCJUGsis3r7QGeQuKxj qOuA== X-Received: by 10.236.98.73 with SMTP id u49mr1822232yhf.153.1385486212854; Tue, 26 Nov 2013 09:16:52 -0800 (PST) Received: from [192.168.0.75] (cpe-72-178-123-130.satx.res.rr.com. [72.178.123.130]) by mx.google.com with ESMTPSA id j67sm60327612yhe.26.2013.11.26.09.16.51 for (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Tue, 26 Nov 2013 09:16:52 -0800 (PST) Message-ID: <5294D782.1080800@gmail.com> Date: Tue, 26 Nov 2013 11:16:50 -0600 From: Bruce Dubbs User-Agent: Mozilla/5.0 (X11; Linux i686; rv:13.0) Gecko/20120628 Firefox/13.0.1 SeaMonkey/2.10.1 MIME-Version: 1.0 To: The development of GNU GRUB Subject: Re: grub-mkimage and other utils documentation References: <20131126204033.44ccb984@opensuse.site> In-Reply-To: <20131126204033.44ccb984@opensuse.site> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2607:f8b0:4002:c01::22e X-BeenThere: grub-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list Reply-To: The development of GNU GRUB List-Id: The development of GNU GRUB List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 26 Nov 2013 17:17:11 -0000 Andrey Borzenkov wrote: > I started to clean --pubkey in docs, hit grub-mkimage reference, hit > "grub-install is just a shell script" ... it really needs cleanup. Is > grub-install terse description intentional? If not, I'm going to > actually document all utilities and all options not defined as hidden. > We probably need to mention common options between various utilities > as well. > > Or should some tools be skipped? I'm fine to document them in > grub-devel though, but I'd like to have them documented /somewhere/. Things that can be run by a user or admin should be in the main documentation. Those things run by a developer for building/testing/debugging, etc should be in grub-devel. I'd put any program that is installed in the file system /{,usr/}{,s}bin directories in the category of admin. -- Bruce