unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



cedit(1)							     cedit(1)



NAME

  cedit	- Invokes the UDC Manager utility

SYNOPSIS

  cedit	[-h] [-c old_db] [-r ref_db] [cur_db]

OPTIONS

  -h  Displays the usage message.

  -c old_db
      Copies and converts old format font file or character attribute data-
      base to the new format used by cedit.

  -r ref_db
      Sets the reference attribute database rather than	using the system
      default.

OPERANDS

  cur_db
      Specifies	the UDC	attribute database to be edited.  If this parameter
      is not given, the	default	user database is used or, if user databases
      are not enabled, the system database is used.  The location of the
      default user and system databases	are determined by the entry for	the
      udc service in the cp_dirs file (see cp_dirs(4)).	 The default path-
      names are	/var/i18n/udc for the system database and ~/.udc for the user
      database.	When the user pathname field in	the udc	entry contains a
      hyphen (-), user databases are disabled for the system.

DESCRIPTION

  The cedit command invokes the	UDC Manager utility, which manages the attri-
  butes	of user-defined	characters (UDCs). You can run UDC Manager to create
  or edit a font glyph for the character and to	manipulate the following
  character attributes:

    +  Symbolic	name

    +  Bitmap font size	(16x18,	24x24, 32x32, 40x40) and style

    +  Codeset value

    +  Collating value

    +  Input key sequences for some of the supported input methods

    +  Character classes

  The actual number and	type of	character attributes that you can manipulate
  for each language depends on the corresponding character configuration
  files.

  The utility has two modes of operation, menu mode and	font-editing mode.
  When you start the utility, it is in menu mode. In menu mode,	the screen is
  divided into 3 parts.	The upper half of the screen is	the work space for
  the menu system. Below that is the status area for showing the current
  codeset and language.	 The bottom two	lines form the user input and message
  display area.	In menu	mode, you manipulate character attributes through
  menu selections; however, you	cannot create or change	the font glyph.	To
  edit the glyph, you must select the Font item	in the Edit menu. This selec-
  tion changes the utility to font-editing mode, where you use single and
  double keystroke commands for	editing. For more information about changing
  character attributes and editing font	glyphs,	see the	Menu Mode and Font-
  Editing Mode sections, respectively.

  The UDC attribute database is	not used directly by system utilities.
  Information in this database must be processed by the	cgen command to
  create data files that are used by system utilities. Refer to	cgen(1)	for
  information about processing information in the UDC attribute	database.

  Menu Mode


  The UDC Manager provides a menu navigation system for	command	selection and
  activation.  In the menu mode, there is a horizontal main menu bar at	the
  top of the screen.  This menu	bar has	several	different menu items for you
  to select and	activate.

  A menu item can be in	one of the following states:

    +  inactive

    +  active

    +  selected

    +  activated

  An inactive menu item	does not have a	highlighted and	underlined letter and
  cannot be selected.

  An active menu item has a highlighted	and underlined letter and can be
  selected.  The highlighted letter specifies the hot key for fast selection
  and activation of this menu item.

  A selected menu item appears in inverse video.  It is	ready for subsequent
  activation.

  An activated menu item is the	one whose submenu has popped up	on the screen
  or one whose function	has started.

  You can use one of two methods to navigate within the	menu system. You can
  use the four arrow keys to move the location cursor to various parts of the
  menu,	or you can press the hot key for fast selection	and activation of
  menu item.

  For the horizontal main menu bar, you	can press the Down-arrow, Space, or
  Return key to	activate a selected item. A pull-down submenu appears for the
  activated menu item.	Pressing the Left-arrow	or Right-arrow key selects
  and activates	the corresponding menu item on the main	menu bar.  To
  activate a selected item in a	pull-down menu,	you can	use either the Return
  or the Space key.

  When >>>> characters follow a menu item, activating that item causes a sub-
  menu to pop up. To return to a higher	menu level without activating an item
  on the current level,	press Ctrl/X.

  To elicit short help for each	menu item, press the Help key.

  The main menu	bar has	the following pull-down	menus:

    +  File

    +  Edit

    +  Delete

    +  Show

    +  Commands

    +  Options

    +  Help

  The File menu	allows you to exit or quit the UDC Manager as well as chang-
  ing the reference character attribute	database.  This	menu also lets you
  save changes made to the current character or	cancel all the changes made
  to that character.

  The Edit menu	allows you to select the current character and edit each
  individual attribute of that character.  Activation of the Font item
  changes the UDC Manager to font-editing mode.

  The Delete menu allows you to	delete previously defined attributes of	the
  current character.

  The Show menu	allows you to show the status and values of character attri-
  butes	already	defined. (However, you cannot view the font glyph through
  this menu.)

  The Commands menu lets you scale a number of font records of a certain font
  size,	list all the characters	available in the current database for the
  current codeset and language,	and copy a number of character records from
  the reference	character attribute database to	the current database.

  The Options menu allows you to change	the current codeset and	language.
  These	options	do not change the language of the utility's user interface.
  Your options for the user interface language are limited to English and the
  language determined by the locale setting at utility startup time.

  The Help menu	provides online	information about the utility.

  For some menu	items, a selection list	will be	popped up for you to choose
  one or more of the character attributes.  To choose or mark a	character
  attribute, press the space bar or the	Return key.

  Font Editing Mode


  The UDC Manager provides a full screen font editor for creating and modify-
  ing character	font patterns.	The following paragraphs give a	brief intro-
  duction to the screen	layout and features available to the user.

  On the top left corner of the	font editor, there are three small windows
  under	the heading "Reference".  They are used	by the Refer mechanism to
  display other	font patterns in their real size so that users can use these
  fonts	as a reference when designing new fonts.

  The Display window under the three Refer windows is for displaying the font
  currently being edited in its	real size.  The	main window on the right side
  of the editor	is the Edit window on which users can create or	modify fonts
  using	cursor movements and editing functions.	Each dot inside	the window
  represents one pixel.	 The patterns in the Display and Edit windows may not
  match.  To make them match, press the	DISPLAY	key (KP.) should be pressed.

  There	are four Edit modes that you can set to	control	the characteristics
  of the editing functions.  The Cursor	mode can be ON,	OFF, ON/OFF or MOVE.
  It controls whether cursor movement turns on or off the pixel	under the
  cursor.  The Paste mode can be OVERLAY or OVERWRITE and controls the out-
  come of paste	operation.  The	Type mode can be BODY or LETTER	and specifies
  whether a boundary is	kept around the	character.  The	Wrap mode can be ON
  or OFF to enable or disable wrapping of the cursor.

  Buffers in the Font Editor are the areas where bitmaps are saved. There are
  four of them.	 The EDIT buffer is the	main buffer where you edit the font
  glyph. This is the buffer that normally appears in the Edit window. The USE
  buffer is the	buffer that appears in the Edit	window when the	USE function
  is invoked.  The third buffer	is the CUT and PASTE buffer.  The content of
  this buffer is not visible, but users	can cut	a pattern from the other two
  buffers to this buffer or paste its contents into the	EDIT buffer.

  Most of the editing functions	are invoked by pressing	a single key on	the
  keypad of the	keyboard. But some functions are invoked by pressing PF1,
  called the GOLD key, and another key.	The GOLD key changes the editing
  function that	is mapped by default to	the second key.

  The Font Editor also provides	a small	pop-up menu for	the SCALE, USE and
  REFER	functions.  Except the SCALE function, these functions can also	be
  invoked by keystroke.

  The SCALE function allows users to scale the current font to other sizes
  supported by the system.

  The USE function allows users	to retrieve a font from	the character attri-
  bute databases or from one of	the Reference windows for a cut	and paste
  operation.

  The REFER function allows users to save either the current edited font or a
  font from the	one of the databases into one of the three reference windows
  in a round-robin fashion.

  For more information about each individual function, you can invoke the
  HELP function	within the Font	Editor.	 The following table specifies the
  terminal key bindings	for all	the editing functions:

  __________________________________________________________________
  Editing Function   Key Binding   Description
  __________________________________________________________________
  HELP		     Help,PF2

				   Provides help on various edit
				   functions
  GOLD		     PF1	   Toggles GOLD	state
  CURSOR-MODE	     PF3	   Toggles Cursor mode
  PASTE-MODE	     PF4	   Toggles Paste mode
  TYPE-MODE	     KP-	   Toggles Type	mode
  WRAP-MODE	     KP,	   Toggles Wrap	mode
  U&L		     KP7

				   Depending on	Cursor mode, moves
				   up &	left
  UP		     KP8

				   Depending on	Cursor mode, moves
				   up
  U&R		     KP9

				   Depending on	Cursor mode, moves
				   up &	right
  LEFT		     KP4

				   Depending on	Cursor mode, moves
				   left
  RIGHT		     KP6

				   Depending on	Cursor mode, moves
				   right


  D&L		     KP1

				   Depending on	Cursor mode, moves
				   down	& left
  DOWN		     KP2

				   Depending on	Cursor mode, moves
				   down


  D&R		     KP3

				   Depending on	Cursor mode, moves
				   down	& right
  USE		     KP0

				   Displays font pattern in USE
				   buffer
  DISPLAY	     KP.

				   Displays font pattern in real
				   size
  TOGGLE	     KP5

				   Toggles ON/OFF state	of pixel
				   under cursor
  EXIT		     Enter	   Saves changes and exit editor
  QUIT		     GOLD Enter

				   Quits editor	without	saving
				   changes
  CLEAR		     GOLD KP,

				   Clears font pattern on Edit win-
				   dow
  REFER		     GOLD KP.

				   Displays font pattern in Refer
				   windows
  RETUSE	     GOLD KP0

				   Returns to EDIT buffer from USE
				   buffer
  ULCORNER	     GOLD KP7	   Jumps to upper left corner
  TOP		     GOLD KP8	   Jumps to top
  URCORNER	     GOLD KP9	   Jumps to upper right	corner
  LSIDE		     GOLD KP4	   Jumps to left side
  CENTER	     GOLD KP5	   Jumps to center
  RSIDE		     GOLD KP6	   Jumps to right side
  LLCORNER	     GOLD KP1	   Jumps to lower left corner
  BOTTOM	     GOLD KP2	   Jumps to bottom
  LRCORNER	     GOLD KP3	   Jumps to lower right	corner
  SELECT	     SELECT

				   Toggles start/cancel	selected
				   area
  PASTE		     INSERT	   Inserts content of paste buffer
  CUT		     REMOVE

				   Cuts	selected area to paste
				   buffer
  COPY		     GOLD REMOVE

				   Copies selected area	to paste
				   buffer
  UP-ARROW	     Up		   Moves up
  DOWN-ARROW	     Down	   Moves down
  LEFT-ARROW	     Left	   Moves up
  RIGHT-ARROW	     Right	   Moves down
  SHIFT-UP	     GOLD Up	   Shifts up by	one line
  SHIFT-DOWN	     GOLD Down	   Shifts down by one line
  SHIFT-LEFT	     GOLD Left	   Shifts left by one column
  SHIFT-RIGHT	     GOLD Right	   Shifts right	by one column
  LINE		     l,L

				   Draws line connecting two
				   selected points
  CIRCLE	     c,C

				   Draws circle	with center at
				   selected point
  O-RECTANGLE	     r

				   Draws an open rectangle in
				   selected area
  S-RECTANGLE	     R

				   Draws an solid rectangle in
				   selected area
  O-ELLIPSE	     e

				   Draws an open ellipse in selected
				   area
  S-ELLIPSE	     E

				   Draws an solid ellipse in
				   selected area
  MIRROR-X	     x,X	   Mirrors pattern along X-axis
  MIRROR-Y	     y,Y	   Mirrors pattern along Y-axis
  MIRROR-45	     /

				   Mirrors pattern along 45-deg
				   diagonal
  MIRROR-135	     \

				   Mirrors pattern along 135-deg
				   diagonal

  FILL		     f,F

				   Depending on	Cursor mode, fills
				   area
  INVERT	     t,T

				   Inverts the pixel state of all
				   pixels
  UNDO		     u,U	   Undoes the previous function
  REDRAW	     Ctrl/L	   Redraws the screen
  B
  SUSPEND	     Ctrl/Z	   Suspends the	program
  MENU		     Do		   Invokes the menu subsystem
  __________________________________________________________________

  The following	keypad diagrams	show the key assignments for the cursor	and
  application keypads. In these	diagrams, the GOLD key functions are preceded
  by an	asterisk.

       +--------+---------+--------++----------+---------+----------+---------+
       |	|	  | *Copy  ||	       |	 |	    |	      |
       |	|  Paste  |  Cut   ||  Gold    |  Help	 | Curs	Mo. |Paste Mo.|
       +--------+---------+--------++----------+---------+----------+---------+
       |	|	  |	   ||*UL Corner|  *Top	 |*UR Corner|	      |
       | Select	|	  |	   || U&L      |   Up	 | U&R	    |Type Mo. |
       +--------+---------+--------++----------+---------+----------+---------+
		|*Shift	Up|	   || *L Side  | *Center | *R Side  |*Clear   |
		| Up	  |	   ||  Left    |  Toggle |  Right   | Wrap Mo.|
       +--------+---------+--------++----------+---------+----------+---------+
       |*Shift L| *Shift D|*Shift R||*LL Corner| *Bottom |*LR Corner|	      |
       | Left	|  Down	  | Right  || D&L      |  Down	 | D&R	    | *Quit   |
       +--------+---------+--------++----------+---------+----------+  Exit   |
				    |  *Return from Use	 | *Refer   |	      |
				    |	Use		 |  Display |	      |
				    +--------------------+----------+---------+

  Starting an Edit Session


  An edit session is normally started by selecting the codeset value of	the
  UDC character	to be edited under the current locale.	By selecting Charac-
  ter item from	the Edit menu, you are prompted	by a submenu with two possi-
  ble choices: edit a new character or edit an existing	character.  In either
  case,	you must enter the character's codeset value in	hexadecimal.  An
  error	message	is be displayed	if you choose to edit a	new character whose
  value	already	exists in the database,	or if you choose to edit an existing
  character when it doesn't exist in the database.

  Under	the Japanese locales, automatic	UDC code point mapping is performed.
  This means that when you enter a new UDC's codeset value for the current
  locale, the value is also mapped, whenever possible, to corresponding
  values in codesets for other Japanese	locales. If you	later decide to
  modify the codeset value of a	Japanese UDC character,	you are	prompted to
  determine if the character value in other codesets should be changed
  accordingly.

  The following	diagram	shows the mapping between UDC regions in the four
  supported Japanese codesets.

       +-----------------+-------------------+-----------------+
       |    deckanji/	 |	 eucJP	     |	     SJIS      |
       |    sdeckanji	 |		     |		       |
       +-----------------+-------------------+-----------------+
       |  0xA121-0xAA7E	 |   0xF5A1-0XFEFE   |	0xF040-0xF4FC  |
       |  0xAB21-0xB47E	 | 0x8FF5A1-0x8FFEFE |	0xF540-0xF9FC  |
       |  0xB521-0xBA7E	 | 0x8FEEA1-0x8FF3FE |	0xFA40-0xFCFC  |
       |  0xBB21-0xBB7E	 | 0x8FF4A1-0x8FF4FE |	    -----      |
       |  0xBC21-0xFE7E	 |	 -----	     |	    -----      |
       +-----------------+-------------------+-----------------+

  If a value in	a particular codeset cannot be mapped to another codeset, the
  value	is left	unchanged or unspecified.

  After	specifying the codeset value, you can proceed to add, modify, or
  delete other editable	character attributes.  Not all the character attri-
  butes	can be edited under any	locale.	 For example, under the	Japanese
  locales, the collating value and input key sequence for a UDC	cannot be
  edited.

SEE ALSO

  Commands: cgen(1)

  Files: cp_dirs(4)

  Others: i18n_intro(5), l10n_intro(5)

  Writing Software for the International Market