[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 01/01: src/devices/grolj4/*: Improve the license information.
From: |
Bernd Warken |
Subject: |
[groff] 01/01: src/devices/grolj4/*: Improve the license information. |
Date: |
Wed, 17 Sep 2014 14:01:55 +0000 |
bwarken pushed a commit to branch master
in repository groff.
commit 36c3dfe23d8ca2af632020550323db01c355fc70
Author: Bernd Warken <address@hidden>
Date: Wed Sep 17 16:01:38 2014 +0200
src/devices/grolj4/*: Improve the license information.
---
src/devices/grolj4/Makefile.sub | 5 +-
src/devices/grolj4/grolj4.man | 48 +++++++++++-----
src/devices/grolj4/lj4.cpp | 3 +-
src/devices/grolj4/lj4_font.man | 119 +++++++++++++++++++++++++++++----------
4 files changed, 124 insertions(+), 51 deletions(-)
diff --git a/src/devices/grolj4/Makefile.sub b/src/devices/grolj4/Makefile.sub
index f2eb5bf..60f7bf9 100644
--- a/src/devices/grolj4/Makefile.sub
+++ b/src/devices/grolj4/Makefile.sub
@@ -2,10 +2,7 @@
#
# File position: <groff-source>/src/devices/grolj4/Makefile.sub
#
-# Copyright (C) 2014
-# Free Software Foundation, Inc.
-#
-# Last update: 2 Sep 2014
+# Copyright (C) 2014 Free Software Foundation, Inc.
#
# This file is part of `font utf8' which is part of `groff'.
#
diff --git a/src/devices/grolj4/grolj4.man b/src/devices/grolj4/grolj4.man
index 169595b..82d296e 100644
--- a/src/devices/grolj4/grolj4.man
+++ b/src/devices/grolj4/grolj4.man
@@ -1,6 +1,12 @@
-.ig
-Copyright (C) 1994-2002, 2004, 2006, 2009, 2014
- Free Software Foundation, Inc.
+.\" -*- nroff -*-
+.TH GROLJ4 @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
+.SH NAME
+grolj4 \- groff driver for HP Laserjet 4 family
+.
+.
+.\" license
+.de co
+Copyright (C) 1994-2014 Free Software Foundation, Inc.
Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice
@@ -17,6 +23,7 @@ versions, except that this permission notice may be included
in
translations approved by the Free Software Foundation instead of in
the original English.
..
+.
.\" Like TP, but if specified indent is more than half
.\" the current line-length - indent, use the default indent.
.de Tp
@@ -24,14 +31,10 @@ the original English.
. el .TP "\\$1"
..
.
-.
-.TH GROLJ4 @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
-.
-.SH NAME
-grolj4 \- groff driver for HP Laserjet 4 family
-.
-.
+.\" --------------------------------------------------------------------
.SH SYNOPSIS
+.\" --------------------------------------------------------------------
+.
.nr a \n(.j
.ad l
.nr i \n(.i
@@ -55,8 +58,10 @@ grolj4 \- groff driver for HP Laserjet 4 family
.ad \na
.
.
-.
+.\" --------------------------------------------------------------------
.SH DESCRIPTION
+.\" --------------------------------------------------------------------
+.
.B grolj4
is a driver for
.B groff
@@ -78,7 +83,10 @@ printers that do not support HPGL/2 unlike the other
commands.
.
.
+.\" --------------------------------------------------------------------
.SH OPTIONS
+.\" --------------------------------------------------------------------
+.
.PP
It is possible to have whitespace between a command line option and its
parameter.
@@ -153,7 +161,10 @@ The integer value
must be in the range 0 to 65535; default is\~0.
.
.
+.\" --------------------------------------------------------------------
.SH ENVIRONMENT
+.\" --------------------------------------------------------------------
+.
.TP
.SM
.B GROFF_FONT_PATH
@@ -168,7 +179,10 @@ and
for more details.
.
.
+.\" --------------------------------------------------------------------
.SH FILES
+.\" --------------------------------------------------------------------
+.
.TP
.B @FONTDIR@/devlj4/DESC
Device description file.
@@ -188,7 +202,10 @@ Macros for use with
Small dots.
.
.
+.\" --------------------------------------------------------------------
.SH "SEE ALSO"
+.\" --------------------------------------------------------------------
+.
.BR lj4_font (@MAN5EXT@),
.BR groff (@MAN1EXT@),
.BR @address@hidden (@MAN1EXT@),
@@ -196,6 +213,9 @@ Small dots.
.BR groff_font (@MAN5EXT@),
.BR groff_char (@MAN7EXT@)
.
-.\" Local Variables:
-.\" mode: nroff
-.\" End:
+.
+.\" --------------------------------------------------------------------
+.SH COPYING
+.\" --------------------------------------------------------------------
+.
+.co
diff --git a/src/devices/grolj4/lj4.cpp b/src/devices/grolj4/lj4.cpp
index f6d7291..859fe2e 100644
--- a/src/devices/grolj4/lj4.cpp
+++ b/src/devices/grolj4/lj4.cpp
@@ -1,6 +1,5 @@
// -*- C++ -*-
-/* Copyright (C) 1994, 2000, 2001, 2002, 2003, 2004, 2006, 2009
- Free Software Foundation, Inc.
+/* Copyright (C) 1994-2014 Free Software Foundation, Inc.
Written by James Clark (address@hidden)
This file is part of groff.
diff --git a/src/devices/grolj4/lj4_font.man b/src/devices/grolj4/lj4_font.man
index 984edc1..894abd3 100644
--- a/src/devices/grolj4/lj4_font.man
+++ b/src/devices/grolj4/lj4_font.man
@@ -1,6 +1,12 @@
.tr ~
-.ig
-Copyright (C) 2004, 2009, 2014 Free Software Foundation, Inc.
+.TH LJ4_FONT @MAN5EXT@ "@MDATE@" "Groff Version @VERSION@"
+.SH NAME
+lj4_font \- groff fonts for use with devlj4
+.
+.
+.\" license
+.de co
+Copyright (C) 2004-2014 Free Software Foundation, Inc.
Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice
@@ -17,40 +23,47 @@ versions, except that this permission notice may be
included in
translations approved by the Free Software Foundation instead of in
the original English.
..
+.
.\" Like TP, but if specified indent is more than half
.\" the current line-length - indent, use the default indent.
.de Tp
.ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
.el .TP "\\$1"
..
+.
.tr ~
-.TH LJ4_FONT @MAN5EXT@ "@MDATE@" "Groff Version @VERSION@"
-.\" --------------------------------------------------------------------------
-.SH NAME
-.\" --------------------------------------------------------------------------
-lj4_font \- groff fonts for use with devlj4
-.\" --------------------------------------------------------------------------
+.\" --------------------------------------------------------------------
.SH DESCRIPTION
-.\" --------------------------------------------------------------------------
+.\" --------------------------------------------------------------------
+.
Nominally, all Hewlett-Packard LaserJet~4\(enseries and newer printers
have the same internal fonts: 45 scalable fonts and one bitmapped
Lineprinter font.
-The scalable fonts are available in sizes between 0.25 point and 999.75
-points, in 0.25-point increments; the Lineprinter font is available only
-in 8.5-point size.
+.
+The scalable fonts are available in sizes between 0.25 point and
+999.75 points, in 0.25-point increments; the Lineprinter font is
+available only in 8.5-point size.
+.
+.
.LP
The LaserJet font files included with
.B groff
assume that all printers since the LaserJet~4 are identical.
-There are some differences between fonts in the earlier and more recent
-printers, however.
+.
+There are some differences between fonts in the earlier and more
+recent printers, however.
+.
The LaserJet~4 printer used Agfa Intellifont technology for 35 of the
-internal scalable fonts; the remaining 10 scalable fonts were TrueType.
-Beginning with the LaserJet~4000\(enseries printers introduced in 1997,
-all scalable internal fonts have been TrueType.
-The number of printable glyphs differs slightly between Intellifont and
-TrueType fonts (generally, the TrueType fonts include more glyphs), and
-there are some minor differences in glyph metrics.
+internal scalable fonts; the remaining 10 scalable fonts were
+TrueType.
+.
+Beginning with the LaserJet~4000\(enseries printers introduced in
+1997, all scalable internal fonts have been TrueType.
+.
+The number of printable glyphs differs slightly between Intellifont
+and TrueType fonts (generally, the TrueType fonts include more
+glyphs), and there are some minor differences in glyph metrics.
+.
Differences among printer models are described in the
.I "PCL~5 Comparison Guide"
and the
@@ -59,92 +72,126 @@ and the
.LP
LaserJet printers reference a glyph by a combination of a 256-glyph
symbol set and an index within that symbol set.
+.
Many glyphs appear in more than one symbol set; all combinations of
symbol set and index that reference the same glyph are equivalent.
+.
For each glyph,
.BR hpftodit (@MAN1EXT@)
-searches a list of symbol sets, and selects the first set that contains
-the glyph.
+searches a list of symbol sets, and selects the first set that
+contains the glyph.
+.
The printing code generated by
.BR hpftodit (@MAN1EXT@)
is an integer that encodes a numerical value for the symbol set in the
high byte(s), and the index in the low byte.
+.
See
.BR groff_font (@MAN5EXT@)
for a complete description of the font file format; symbol sets are
described in greater detail in the
.IR "PCL~5 Printer Language Technical Reference Manual" .
+.
+.
.LP
Two of the scalable fonts, Symbol and Wingdings, are bound to
256-glyph symbol sets; the remaining scalable fonts, as well as the
Lineprinter font, support numerous symbol sets, sufficient to enable
printing of more than 600 glyphs.
+.
+.
.LP
The metrics generated by
.BR hpftodit (@MAN1EXT@)
assume that the DESC file contains values of 1200 for res and 6350 for
unitwidth (or any combination (e.g., 2400 and 3175) for which
res~\(mu~unitwidth~=~7\|620\|000).
+.
Although HP PCL~5 LaserJet printers support an internal resolution of
7200 units per inch, they use a 16-bit signed integer for cursor
positioning; if
.B devlj4
is to support U.S.\& ledger paper (11"~\(mu~17"), the maximum usable
-resolution is 32\|767~/~17, or 1927, units per inch, which rounds down to
-1200 units per inch.
+resolution is 32\|767~/~17, or 1927, units per inch, which rounds down
+to 1200 units per inch.
+.
If the largest required paper size is less (e.g., 8.5"~\(mu~11" or
A5), a greater resolution (and lesser unitwidth) can be specified.
-.\" --------------------------------------------------------------------------
+.
+.
+.\" --------------------------------------------------------------------
.SH LIMITATIONS
-.\" --------------------------------------------------------------------------
+.\" --------------------------------------------------------------------
+.
Font metrics for Intellifont fonts were provided by Tagged Font Metric
(TFM) files originally developed by Agfa/Compugraphic.
+.
The TFM files provided for these fonts supported 600+ glyphs and
contained extensive lists of kern pairs.
+.
+.
.LP
To accommodate developers who had become accustomed to TFM files, HP also
provided TFM files for the 10 TrueType fonts included in the LaserJet~4.
+.
The TFM files for TrueType fonts generally included less information
than the Intellifont TFMs, supporting fewer glyphs, and in most cases,
providing no kerning information.
+.
By the time the LaserJet~4000 printer was introduced, most
developers had migrated to other means of obtaining font metrics,
and support for new TFM files was very limited.
+.
The TFM files provided for the TrueType fonts in the LaserJet~4000
support only the Latin 2 (ISO 8859-2) symbol set, and include no kerning
information; consequently, they are of little value for any but the most
rudimentary documents.
+.
+.
.LP
-Because the Intellifont TFM files contain considerably more information,
-they generally are preferable to the TrueType TFM files even for use
-with the TrueType fonts in the newer printers.
+Because the Intellifont TFM files contain considerably more
+information, they generally are preferable to the TrueType TFM files
+even for use with the TrueType fonts in the newer printers.
+.
The metrics for the TrueType fonts are very close, though not identical,
to those for the earlier Intellifont fonts of the same names.
+.
Although most output using the Intellifont metrics with the newer
printers is quite acceptable, a few glyphs may fail to print as
expected.
+.
The differences in glyph metrics may be particularly noticeable with
composite parentheses, brackets, and braces used by
.BR eqn (@MAN1EXT@) .
+.
A script, located in
.BR @FONTDIR@/devlj4/generate ,
can be used to adjust the metrics for these glyphs in the special font S
for use with printers that have all TrueType fonts.
+.
+.
.LP
At the time HP last supported TFM files, only Version 1 of the Unicode
standard was available.
+.
Consequently, many glyphs lacking assigned code points were assigned by
HP to the Private Use Area (PUA).
+.
Later versions of the Unicode standard included code points outside the
PUA for many of these glyphs.
+.
The HP-supplied TrueType TFM files use the PUA assignments;
TFM files generated from more recent TrueType font files require the
later Unicode values to access the same glyphs.
+.
Consequently, two different mapping files may be required: one for the
HP-supplied TFM files, and one for more recent TFM files.
+.
+.
.\" --------------------------------------------------------------------------
.SH FILES
.\" --------------------------------------------------------------------------
+.
.Tp \w'address@hidden@/devlj4/DESC'u+2n
.B @FONTDIR@/devlj4/DESC
Device description file.
@@ -152,9 +199,11 @@ Device description file.
.BI @FONTDIR@/devlj4/ F
Font description file for font
.IR F .
-.\" --------------------------------------------------------------------------
+.
+.
+.\" --------------------------------------------------------------------
.SH "SEE ALSO"
-.\" --------------------------------------------------------------------------
+.\" --------------------------------------------------------------------
.ad 0
.BR groff (@MAN1EXT@),
.BR groff_diff (@MAN1EXT@),
@@ -162,6 +211,14 @@ Font description file for font
.BR grolj4 (@MAN1EXT@),
.BR groff_font (@MAN5EXT@)
.
+.
+.\" --------------------------------------------------------------------
+.SH COPYING
+.\" --------------------------------------------------------------------
+.
+.co
+.
+.
.\" Local Variables:
.\" mode: nroff
.\" End:
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 01/01: src/devices/grolj4/*: Improve the license information.,
Bernd Warken <=