From f70704550d7a2d31fb84475c754c4a9b4f38781b Mon Sep 17 00:00:00 2001 From: Robert Schwebel Date: Sun, 11 Jul 2010 12:13:22 +0200 Subject: doc: add documentation for 'bmp' Signed-off-by: Robert Schwebel --- Documentation/commands.dox | 1 + commands/bmp.c | 27 +++++++++++++++++++-------- 2 files changed, 20 insertions(+), 8 deletions(-) diff --git a/Documentation/commands.dox b/Documentation/commands.dox index e8ad177f15..ac280d6190 100644 --- a/Documentation/commands.dox +++ b/Documentation/commands.dox @@ -2,6 +2,7 @@ * @page command_reference Supported Shell Commands @li @subpage addpart_command +@li @subpage bmp_command @li @subpage cat_command @li @subpage cd_command @li @subpage cp_command diff --git a/commands/bmp.c b/commands/bmp.c index 6e17200a1a..5bac031004 100644 --- a/commands/bmp.c +++ b/commands/bmp.c @@ -193,17 +193,28 @@ failed_memmap: return 1; } -static const __maybe_unused char cmd_bmp_help[] = -"Usage: bmp [OPTION]... FILE\n" -"show bmp image FILE.\n" -" -f framebuffer device (/dev/fb0)\n" -" -x x offset (default center)\n" -" -y y offset (default center)\n" -" -o render offscreen\n"; +BAREBOX_CMD_HELP_START(bmp) +BAREBOX_CMD_HELP_USAGE("bmp [OPTIONS] FILE\n") +BAREBOX_CMD_HELP_SHORT("Show the bitmap FILE on the framebuffer.\n") +BAREBOX_CMD_HELP_OPT ("-f ", "framebuffer device (/dev/fb0)\n") +BAREBOX_CMD_HELP_OPT ("-x ", "x offset (default center)\n") +BAREBOX_CMD_HELP_OPT ("-y ", "y offset (default center)\n") +BAREBOX_CMD_HELP_OPT ("-o", "render offscreen\n") +BAREBOX_CMD_HELP_END + +/** + * @page bmp_command + +This command displays a graphics in the bitmap (.bmp) format on the +framebuffer. Currently the bmp command supports images with 8 and 24 bit +color depth. + +\todo What does the -o (offscreen) option do? + + */ BAREBOX_CMD_START(bmp) .cmd = do_bmp, .usage = "show a bmp image", BAREBOX_CMD_HELP(cmd_bmp_help) BAREBOX_CMD_END - -- cgit v1.2.3