mail archive of the barebox mailing list
 help / color / mirror / Atom feed
From: Antony Pavlov <antonynpavlov@gmail.com>
To: Sascha Hauer <s.hauer@pengutronix.de>
Cc: barebox@lists.infradead.org
Subject: Re: [PATCH 00/19] commands rework patch series
Date: Wed, 14 May 2014 17:55:40 +0400	[thread overview]
Message-ID: <20140514175540.56dbdf584330f67779392264@gmail.com> (raw)
In-Reply-To: <20140514070250.GV5858@pengutronix.de>

On Wed, 14 May 2014 09:02:50 +0200
Sascha Hauer <s.hauer@pengutronix.de> wrote:

> On Tue, May 13, 2014 at 10:28:40AM +0200, Holger Schurig wrote:
> > Hi,
> > 
> > this is my current patch series that should improve barebox'
> > documentation about it's commands.
> > 
> > * when I started barebox and typed "help", the list of commands
> >   was scrolling up quickly. Almost always did I had to use the
> >   mouse and scroll my x-terminal backwards to see what I
> >   actually wanted to see. So I reduced the output of the "help"
> >   command to just spit out the command names, however grouped
> >   by functions. This is now much smaller and fits in one
> >   screen. The old list is available with "help -l".
> > * Usage (synopsis) documention (e.g. "ls [-lCR]") was only in
> >   the CONFIG_LONGHELP, but it's often usable if one forget the
> >   exact command option letter. It's now part of the help even
> >   without CONFIG_LONGHELP.
> > * I reworked the long help texts to make them better understandable
> >   (hopefully), and also tried to recuce their size if possible.
> > * when I was new to barebox, I was wandering if I need some
> >   of the commands in "make xconfig". I didn't have further
> >   information, because almost no command had a help text.
> >   This has now changed, the help texts in Kconfig are almost the
> >   same as the help texts of "help FOOBAR" (with CONFIG_LONGHELP) on.
> > * now that "help" has the commands grouped nicely, it was time
> >   to group them in "make xconfig", too
> > * many Kconfig entries turned on commands, but they were located
> >   at various places (a.g. common, net, arch-depended). Moved them
> >   all into commands/Kconfig
> > * some CONFIG_CMD_foobar things didn't turn on commands. I renamed
> >   them (and their occurences in the _defconfig)s.
> 
> Applied with some minor fixups like removing
> BAREBOX_CMD_HELP(cmd_clk_enable_help) which doesn't exist.
> 
> For everyone who hasn't tried this series, here is the nice-and-shiny
> sorted-by-categories output of help -v:
> 
> Information commands:
>   ?                     print online help
>   clk_dump              show information about registered clocks

clkinfo ?

>   cpuinfo               show info about CPU
>   devinfo               show information about devices and drivers
>   gpiolib               list registered GPIOs

gpioinfo?

>   help                  print online help
>   iomem                 show IO memory usage
>   meminfo               print info about memory usage
>   mmuinfo               show MMU/cache information of an address
>   version               print barebox version
> 
> Boot commands:
>   boot                  boot from script, device, ...
>   bootm                 boot an application image
>   go                    start application at address or file
>   reset                 perform RESET of the CPU
>   uimage                extract/verify uImage
> 
> Partition commands:
>   addpart               add a partition description to a device
>   automount             execute (mount) COMMAND when PATH ist first accessed
>   delpart               delete partition(s)
>   mount                 mount a filesystem or list mounted filesystems
>   ubiattach             attach mtd device to UBI
>   ubidetach             detach an UBI device
>   ubimkvol              create an UBI volume
>   ubirmvol              delete an UBI volume
>   umount                umount a filesystem
> 
> Environment commands:
>   export                export environment variables
>   global                create or set global variables
>   loadenv               load environment from ENVFS
>   magicvar              list information about magic variables
>   printenv              print value of environment variables
>   saveenv               save environment to persistent storage
> 
> File commands:
>   basename              strip directory and suffix from filenames
>   cat                   concatenate file(s) to stdout
>   cd                    change working directory
>   cp                    copy files
>   dirname               strip last component from a path
>   filetype              detect file type
>   ln                    create symlink (make a new name for a file)
>   ls                    list a file or directory
>   md5sum                calculate MD5 checksum
>   mkdir                 make directories
>   pwd                   print working directory
>   readlink              read value of a symbolic link
>   rm                    remove files
>   rmdir                 remove empty directory(s)
>   uncompress            uncompress a compressed file
> 
> Scripting commands:
>   .                     execute shell script in current shell environment
>   [                     minimal test command like in /bin/sh
>   exit                  exit script
>   false                 do nothing, unsuccessfully
>   getopt                parse option arguments
>   let                   evaluate arithmetic expressions
>   msleep                delay execution for n milli-seconds
>   readf                 read file into variable
>   sh                    execute a shell script
>   sleep                 delay execution for n seconds
>   source                execute shell script in current shell environment
>   test                  minimal test command like in /bin/sh
>   true                  do nothing, successfully
> 
> Network commands:
>   dhcp                  DHCP client to obtain IP or boot params
>   ethact                get or set current ethernet device
>   ifup                  bring a network interface up
>   miitool               view media-independent interface status
>   ping                  send ICMP echo requests
>   tftp                  load (or save) a file using TFTP
> 
> Console commands:
>   clear                 clear screen
>   echo                  echo args to console
>   edit                  a small full-screen editor
>   menu                  create and display menus
>   readline              prompt for user input
>   sedit                 a small full-screen editor
>   splash                display a BMP image
>   timeout               wait for a specified timeout
> 
> Memory commands:
>   crc32                 CRC32 checksum calculation
>   md                    memory display
>   memcmp                memory compare
>   memcpy                memory copy
>   memset                memory fill
>   memtest               extensive memory test
>   mm                    memory modify with mask
>   mw                    memory write
> 
> Hardware manipulation commands:
>   clk_disable           disable a clock
>   clk_enable            enable a clock
>   clk_set_parent        set parent of a clock
>   clk_set_rate          set a clocks rate
>   detect                detect devices
>   erase                 erase flash memory
>   gpio_direction_input  set direction of a GPIO pin to input
>   gpio_direction_output set direction of a GPIO pin to output
>   gpio_get_value        return value of a GPIO pin
>   gpio_set_value        set a GPIO's output value
>   i2c_probe             probe for an i2c device
>   i2c_read              read from an i2c device
>   i2c_write             write to an i2c device
>   imx_nand_bbm          create BBT for i.MX NAND
>   led                   control LEDs
>   nand                  NAND flash handling
>   protect               enable flash write protection
>   spi                   write/read from SPI device
>   trigger               handle LED triggers
>   unprotect             disable flash write protection
>   usb                   (re-)detect USB devices
>   wd                    enable/disable/trigger the watchdog
> 
> Miscellaneous commands:
>   barebox_update        update barebox to persistent media
>   dfu                   device firmware update
>   of_node               create/delete nodes in the device tree
>   of_property           handle device tree properties
>   oftree                handle device trees

Device Tree commands: ?

>   time                  measure execution duration of a command
> 
> Use 'help COMMAND' for more details.
> 
> 
> 
> -- 
> Pengutronix e.K.                           |                             |
> Industrial Linux Solutions                 | http://www.pengutronix.de/  |
> Peiner Str. 6-8, 31137 Hildesheim, Germany | Phone: +49-5121-206917-0    |
> Amtsgericht Hildesheim, HRA 2686           | Fax:   +49-5121-206917-5555 |
> 
> _______________________________________________
> barebox mailing list
> barebox@lists.infradead.org
> http://lists.infradead.org/mailman/listinfo/barebox


-- 
-- 
Best regards,
  Antony Pavlov

_______________________________________________
barebox mailing list
barebox@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/barebox

  reply	other threads:[~2014-05-14 13:45 UTC|newest]

Thread overview: 35+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2014-05-13  8:28 Holger Schurig
2014-05-13  8:28 ` [PATCH 01/19] commands: group 'help' output Holger Schurig
2014-05-13 13:48   ` Sascha Hauer
2014-05-13 14:07     ` Holger Schurig
2014-05-13  8:28 ` [PATCH 02/19] commands: harmonize in-barebox documentation Holger Schurig
2014-05-13  8:28 ` [PATCH 03/19] commands: harmonize in-barebox docs with Kconfig docs Holger Schurig
2014-05-13  8:28 ` [PATCH 04/19] commands: CMD_MEMORY -> COMPILE_MEMORY Holger Schurig
2014-05-13  8:28 ` [PATCH 05/19] commands: CMD_DIGEST -> COMPILE_DIGEST Holger Schurig
2014-05-13  8:28 ` [PATCH 06/19] commands: move CMD_ARM_CPUINFO to commands/Kconfig Holger Schurig
2014-05-13  8:28 ` [PATCH 07/19] commands: move CMD_ARM_MMUINFO " Holger Schurig
2014-05-13  8:28 ` [PATCH 08/19] commands: move CMD_MIPS_CPUINFO " Holger Schurig
2014-05-13 11:26   ` Antony Pavlov
2014-05-13 11:28     ` Holger Schurig
2014-05-13 12:23       ` Antony Pavlov
2014-05-13 12:43         ` Holger Schurig
2014-05-13 13:09           ` Juergen Borleis
2014-05-13  8:28 ` [PATCH 09/19] commands: move CMD_BOOT_ORDER " Holger Schurig
2014-05-13  8:28 ` [PATCH 10/19] commands: move CMD_AT91_BOOT_TEST " Holger Schurig
2014-05-13  8:28 ` [PATCH 11/19] commands: move CMD_AT91MUX " Holger Schurig
2014-05-13  8:28 ` [PATCH 12/19] commands: move CMD_AT91MIX " Holger Schurig
2014-05-13  8:28 ` [PATCH 13/19] commands: HUSH_GETOPT -> CMD_GETOPT Holger Schurig
2014-05-13  8:28 ` [PATCH 14/19] commands: let all network commands depend on NET Holger Schurig
2014-05-13  8:28 ` [PATCH 15/19] commands: introduce CMD_HOST Holger Schurig
2014-05-13  8:28 ` [PATCH 16/19] commands: NET_PING -> CMD_PING Holger Schurig
2014-05-13  8:28 ` [PATCH 17/19] commands: NET_DHCP -> CMD_DHCP Holger Schurig
2014-05-13  8:28 ` [PATCH 18/19] commands: move CMD_IFUP to commands/Kconfig Holger Schurig
2014-05-13  8:28 ` [PATCH 19/19] commands: move CONFIG_LONGHELP " Holger Schurig
2014-05-13  8:30 ` [PATCH 00/19] commands rework patch series Holger Schurig
2014-05-13  8:41   ` Sascha Hauer
2014-05-13  9:00   ` Holger Schurig
2014-05-13 13:46 ` Sascha Hauer
2014-05-14  7:02 ` Sascha Hauer
2014-05-14 13:55   ` Antony Pavlov [this message]
2014-05-15  8:09     ` Holger Schurig
2014-05-15 11:52       ` Sascha Hauer

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20140514175540.56dbdf584330f67779392264@gmail.com \
    --to=antonynpavlov@gmail.com \
    --cc=barebox@lists.infradead.org \
    --cc=s.hauer@pengutronix.de \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox