1
/* help.c - command to show a help text. */
3
* GRUB -- GRand Unified Bootloader
4
* Copyright (C) 2005,2007,2008,2009 Free Software Foundation, Inc.
6
* GRUB is free software: you can redistribute it and/or modify
7
* it under the terms of the GNU General Public License as published by
8
* the Free Software Foundation, either version 3 of the License, or
9
* (at your option) any later version.
11
* GRUB is distributed in the hope that it will be useful,
12
* but WITHOUT ANY WARRANTY; without even the implied warranty of
13
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14
* GNU General Public License for more details.
16
* You should have received a copy of the GNU General Public License
17
* along with GRUB. If not, see <http://www.gnu.org/licenses/>.
21
#include <grub/misc.h>
22
#include <grub/term.h>
23
#include <grub/extcmd.h>
24
#include <grub/i18n.h>
26
#include <grub/normal.h>
27
#include <grub/charset.h>
30
grub_cmd_help (grub_extcmd_context_t ctxt __attribute__ ((unused)), int argc,
41
if ((cmd->prio & GRUB_PRIO_LIST_FLAG_ACTIVE))
43
struct grub_term_output *term;
44
const char *summary_translated = _(cmd->summary);
46
grub_uint32_t *unicode_command_help;
47
grub_uint32_t *unicode_last_position;
49
command_help = grub_xasprintf ("%s %s", cmd->name, summary_translated);
53
grub_utf8_to_ucs4_alloc (command_help, &unicode_command_help,
54
&unicode_last_position);
56
FOR_ACTIVE_TERM_OUTPUTS(term)
59
grub_uint32_t *unicode_last_screen_position;
61
unicode_last_screen_position = unicode_command_help;
65
while (unicode_last_screen_position < unicode_last_position &&
66
stringwidth < ((grub_term_width (term) / 2) - 2))
68
struct grub_unicode_glyph glyph;
69
unicode_last_screen_position
70
+= grub_unicode_aglomerate_comb (unicode_last_screen_position,
72
- unicode_last_screen_position,
76
+= grub_term_getcharwidth (term, &glyph);
79
grub_print_ucs4 (unicode_command_help,
80
unicode_last_screen_position, 0, 0, term);
82
grub_print_spaces (term, grub_term_width (term) / 2
90
grub_free (command_help);
91
grub_free (unicode_command_help);
102
for (i = 0; i < argc; i++)
107
if (cmd->prio & GRUB_PRIO_LIST_FLAG_ACTIVE)
109
if (! grub_strncmp (cmd->name, currarg, grub_strlen (currarg)))
112
grub_printf ("\n\n");
114
if ((cmd->flags & GRUB_COMMAND_FLAG_EXTCMD) &&
115
! (cmd->flags & GRUB_COMMAND_FLAG_DYNCMD))
116
grub_arg_show_help ((grub_extcmd_t) cmd->data);
118
grub_printf ("%s %s %s\n%s\n", _("Usage:"), cmd->name, _(cmd->summary),
119
_(cmd->description));
129
static grub_extcmd_t cmd;
133
cmd = grub_register_extcmd ("help", grub_cmd_help, 0,
135
N_("Show a help message."), 0);
140
grub_unregister_extcmd (cmd);