> 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. ")