freebsd-dev/gnu/lib/libdialog/help.c

195 lines
4.3 KiB
C
Raw Normal View History

/***************************************************************
1995-05-30 05:05:38 +00:00
*
* Program: help.c
* Author: Marc van Kempen
* Desc: get help
*
*
* Copyright (c) 1995, Marc van Kempen
*
* All rights reserved.
*
* This software may be used, modified, copied, distributed, and
* sold, in both source and binary form provided that the above
* copyright and these terms are retained, verbatim, as the first
* lines of this file. Under no circumstances is the author
* responsible for the proper functioning of this software, nor does
* the author assume any responsibility for damages incurred with
* its use.
1995-05-30 05:05:38 +00:00
*
***************************************************************/
#include <stdlib.h>
#include <sys/param.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <string.h>
#include <dialog.h>
static char _helpfilebuf[MAXPATHLEN];
static char _helplinebuf[77]; /* limit the helpline to 76 characters */
static char *_helpfile = NULL;
static char *_helpline = NULL;
/******************************************************************
*
* helpfile routines
*
******************************************************************/
void
use_helpfile(char *hfile)
/*
* desc: set the helpfile to be opened on pressing F1 to <helpfile>
*/
{
if (hfile != NULL) {
_helpfile = _helpfilebuf;
strcpy(_helpfile, hfile);
} else {
_helpfile = NULL;
}
return;
} /* use_helpfile() */
void
display_helpfile(void)
/*
* desc: display the current helpfile in a window
*/
{
WINDOW *w;
FILE *f;
struct stat sb;
char msg[80], *buf;
static int in_help = FALSE;
char *savehline = NULL;
if (in_help) return; /* dont call help when you're in help */
if (_helpfile != NULL) {
if ((w = dupwin(newscr)) == NULL) {
dialog_notify("No memory to dup previous screen\n");
return;
}
if ((f = fopen(_helpfile, "r")) == NULL) {
sprintf(msg, "Can't open helpfile : %s\n", _helpfile);
dialog_notify(msg);
return;
}
if (fstat(fileno(f), &sb)) {
sprintf(msg, "Can't stat helpfile : %s\n", _helpfile);
dialog_notify(msg);
return;
}
if ((buf = (char *) malloc( sb.st_size )) == NULL) {
sprintf(msg, "Could not malloc space for helpfile : %s\n", _helpfile);
dialog_notify(msg);
return;
}
if (fread(buf, 1, sb.st_size, f) != sb.st_size) {
sprintf(msg, "Could not read entire help file : %s", _helpfile);
dialog_notify(msg);
free(buf);
return;
}
buf[sb.st_size] = 0;
in_help = TRUE;
savehline = get_helpline();
use_helpline("Use arrowkeys, PgUp, PgDn, Home and End to move through text");
dialog_mesgbox("Online help", buf, LINES-4, COLS-4);
restore_helpline(savehline);
in_help = FALSE;
touchwin(w);
wrefresh(w);
delwin(w);
free(buf);
} else {
/* do nothing */
}
return;
} /* display_helpfile() */
1995-05-30 05:05:38 +00:00
/******************************************************************
*
* helpline routines
*
******************************************************************/
void
use_helpline(char *hline)
1995-05-30 05:05:38 +00:00
/*
* desc: set the helpline to printed in dialogs
*/
{
if (hline) {
_helpline = _helplinebuf;
if (strlen(hline) > 76) {
/* only display the first 76 characters in the helpline */
strncpy(_helpline, hline, 76);
_helpline[76] = 0;
} else {
strcpy(_helpline, hline);
}
} else {
_helpline = NULL;
}
return;
} /* use_helpline() */
void
display_helpline(WINDOW *w, int y, int width)
/*
* desc: display the helpline at the given coordinates <y, x> in the window <w>
*/
{
if (_helpline != NULL) {
if (strlen(_helpline) > width - 6) {
_helpline[width - 6] = 0;
}
wmove(w, y, (int) (width - strlen(_helpline)- 4) / 2);
wattrset(w, title_attr);
waddstr(w, "[ ");
waddstr(w, _helpline);
waddstr(w, " ]");
} else {
/* do nothing */
}
return;
}
char *
get_helpline(void)
/*
* desc: allocate new space, copy the helpline to it and return a pointer to it
*/
{
char *hlp;
if (_helpline) {
hlp = (char *) malloc( strlen(_helpline) + 1 );
strcpy(hlp, _helpline);
} else {
hlp = NULL;
}
1995-05-30 05:05:38 +00:00
return(hlp);
} /* get_helpline() */
void
restore_helpline(char *helpline)
/*
* Desc: set the helpline to <helpline> and free the space allocated to it
*/
{
use_helpline(helpline);
free(helpline);
return;
} /* restore_helpline() */