Re: [PATCH v2] gnu: Add sunxi-tools.

[Danny Milosavljevic]

> I don’t understand this description.  Since “Tools”, “manage”, and
> “devices” could mean anything, could you add qualifiers to give more
> context, like:
> 
>   “Frobbing tools for Allwinner A10 foobar devices”
> 
> and similarly expound the description (with a period at the end of the
> sentence)?
> 
> Based on that, we might device that admin.scm is not the best fit for
> this package.  Maybe flashing-tools.scm?

The tools included are:

- sunxi-fexc, bin2fex, fex2bin: Compile a textual description of a board (.fex) 
to a binary representation (.bin). Like Devicetree - if a vendor doesn't know 
Devicetree exists and therefore doesn't use it. [can be used on target and host]
- sunxi-fel: Puts an Allwinner A10 device into FEL mode which makes it register 
as a special USB device (rather than USB host). You can then connect it to 
another computer and flash it from there (kinda like Arduino or other Atmels). 
[only makes sense to be used on host]
- sunxi-nand-part: Partitions NAND flash. [only makes sense to be used on 
target since it uses ioctls specific to the NAND kernel driver]
- sunxi-bootinfo: Reads out boot0 and boot1 information. These are the 
bootloaders before U-Boot. [can be used on target and host - since it requires 
an image file]
- sunxi-pio: Sets GPIO and oscillates a GPIO in order to be able to find it 
[only makes sense to be used on target - since it uses /dev/mem]

So how about this description:

    (description "This package contains tools for Allwinner A10 devices:
- sunxi-fexc, bin2fex, fex2bin: Compile a textual description of a board (.fex) 
to a binary representation (.bin).
- sunxi-fel: Puts a Allwinner A10 device into FEL mode which makes it register 
as a special USB device (rather than USB host). You can then connect it to 
another computer and flash it from there.
- sunxi-nand-part: Partitions NAND flash.
- sunxi-bootinfo: Reads out boot0 and boot1 information. These are the 
bootloaders before U-Boot.
- sunxi-pio: Sets GPIO and oscillates a GPIO in order to be able to find it.
")