3420c70c4629105446ba2a532f0b02024faa4390
[dragonfly.git] / contrib / mdocml / term.c
1 /*      $Id: term.c,v 1.212 2013/12/23 02:20:09 schwarze Exp $ */
2 /*
3  * Copyright (c) 2008, 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
4  * Copyright (c) 2010, 2011, 2012, 2013 Ingo Schwarze <schwarze@openbsd.org>
5  *
6  * Permission to use, copy, modify, and distribute this software for any
7  * purpose with or without fee is hereby granted, provided that the above
8  * copyright notice and this permission notice appear in all copies.
9  *
10  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17  */
18 #ifdef HAVE_CONFIG_H
19 #include "config.h"
20 #endif
21
22 #include <sys/types.h>
23
24 #include <assert.h>
25 #include <ctype.h>
26 #include <stdint.h>
27 #include <stdio.h>
28 #include <stdlib.h>
29 #include <string.h>
30
31 #include "mandoc.h"
32 #include "out.h"
33 #include "term.h"
34 #include "main.h"
35
36 static  size_t           cond_width(const struct termp *, int, int *);
37 static  void             adjbuf(struct termp *p, size_t);
38 static  void             bufferc(struct termp *, char);
39 static  void             encode(struct termp *, const char *, size_t);
40 static  void             encode1(struct termp *, int);
41
42 void
43 term_free(struct termp *p)
44 {
45
46         if (p->buf)
47                 free(p->buf);
48         if (p->symtab)
49                 mchars_free(p->symtab);
50
51         free(p);
52 }
53
54
55 void
56 term_begin(struct termp *p, term_margin head, 
57                 term_margin foot, const void *arg)
58 {
59
60         p->headf = head;
61         p->footf = foot;
62         p->argf = arg;
63         (*p->begin)(p);
64 }
65
66
67 void
68 term_end(struct termp *p)
69 {
70
71         (*p->end)(p);
72 }
73
74 /*
75  * Flush a line of text.  A "line" is loosely defined as being something
76  * that should be followed by a newline, regardless of whether it's
77  * broken apart by newlines getting there.  A line can also be a
78  * fragment of a columnar list (`Bl -tag' or `Bl -column'), which does
79  * not have a trailing newline.
80  *
81  * The following flags may be specified:
82  *
83  *  - TERMP_NOBREAK: this is the most important and is used when making
84  *    columns.  In short: don't print a newline and instead expect the
85  *    next call to do the padding up to the start of the next column.
86  *    p->trailspace may be set to 0, 1, or 2, depending on how many
87  *    space characters are required at the end of the column.
88  *
89  *  - TERMP_DANGLE: don't newline when TERMP_NOBREAK is specified and
90  *    the line is overrun, and don't pad-right if it's underrun.
91  *
92  *  - TERMP_HANG: like TERMP_DANGLE, but doesn't newline when
93  *    overrunning, instead save the position and continue at that point
94  *    when the next invocation.
95  *
96  *  In-line line breaking:
97  *
98  *  If TERMP_NOBREAK is specified and the line overruns the right
99  *  margin, it will break and pad-right to the right margin after
100  *  writing.  If maxrmargin is violated, it will break and continue
101  *  writing from the right-margin, which will lead to the above scenario
102  *  upon exit.  Otherwise, the line will break at the right margin.
103  */
104 void
105 term_flushln(struct termp *p)
106 {
107         size_t           i;     /* current input position in p->buf */
108         int              ntab;  /* number of tabs to prepend */
109         size_t           vis;   /* current visual position on output */
110         size_t           vbl;   /* number of blanks to prepend to output */
111         size_t           vend;  /* end of word visual position on output */
112         size_t           bp;    /* visual right border position */
113         size_t           dv;    /* temporary for visual pos calculations */
114         size_t           j;     /* temporary loop index for p->buf */
115         size_t           jhy;   /* last hyph before overflow w/r/t j */
116         size_t           maxvis; /* output position of visible boundary */
117         size_t           mmax; /* used in calculating bp */
118
119         /*
120          * First, establish the maximum columns of "visible" content.
121          * This is usually the difference between the right-margin and
122          * an indentation, but can be, for tagged lists or columns, a
123          * small set of values.
124          *
125          * The following unsigned-signed subtractions look strange,
126          * but they are actually correct.  If the int p->overstep
127          * is negative, it gets sign extended.  Subtracting that
128          * very large size_t effectively adds a small number to dv.
129          */
130         assert  (p->rmargin >= p->offset);
131         dv     = p->rmargin - p->offset;
132         maxvis = (int)dv > p->overstep ? dv - (size_t)p->overstep : 0;
133         dv     = p->maxrmargin - p->offset;
134         mmax   = (int)dv > p->overstep ? dv - (size_t)p->overstep : 0;
135
136         bp = TERMP_NOBREAK & p->flags ? mmax : maxvis;
137
138         /*
139          * Calculate the required amount of padding.
140          */
141         vbl = p->offset + p->overstep > p->viscol ?
142               p->offset + p->overstep - p->viscol : 0;
143
144         vis = vend = 0;
145         i = 0;
146
147         while (i < p->col) {
148                 /*
149                  * Handle literal tab characters: collapse all
150                  * subsequent tabs into a single huge set of spaces.
151                  */
152                 ntab = 0;
153                 while (i < p->col && '\t' == p->buf[i]) {
154                         vend = (vis / p->tabwidth + 1) * p->tabwidth;
155                         vbl += vend - vis;
156                         vis = vend;
157                         ntab++;
158                         i++;
159                 }
160
161                 /*
162                  * Count up visible word characters.  Control sequences
163                  * (starting with the CSI) aren't counted.  A space
164                  * generates a non-printing word, which is valid (the
165                  * space is printed according to regular spacing rules).
166                  */
167
168                 for (j = i, jhy = 0; j < p->col; j++) {
169                         if (' ' == p->buf[j] || '\t' == p->buf[j])
170                                 break;
171
172                         /* Back over the the last printed character. */
173                         if (8 == p->buf[j]) {
174                                 assert(j);
175                                 vend -= (*p->width)(p, p->buf[j - 1]);
176                                 continue;
177                         }
178
179                         /* Regular word. */
180                         /* Break at the hyphen point if we overrun. */
181                         if (vend > vis && vend < bp && 
182                                         ASCII_HYPH == p->buf[j])
183                                 jhy = j;
184
185                         vend += (*p->width)(p, p->buf[j]);
186                 }
187
188                 /*
189                  * Find out whether we would exceed the right margin.
190                  * If so, break to the next line.
191                  */
192                 if (vend > bp && 0 == jhy && vis > 0) {
193                         vend -= vis;
194                         (*p->endline)(p);
195                         p->viscol = 0;
196                         if (TERMP_NOBREAK & p->flags) {
197                                 vbl = p->rmargin;
198                                 vend += p->rmargin - p->offset;
199                         } else
200                                 vbl = p->offset;
201
202                         /* use pending tabs on the new line */
203
204                         if (0 < ntab)
205                                 vbl += ntab * p->tabwidth;
206
207                         /*
208                          * Remove the p->overstep width.
209                          * Again, if p->overstep is negative,
210                          * sign extension does the right thing.
211                          */
212
213                         bp += (size_t)p->overstep;
214                         p->overstep = 0;
215                 }
216
217                 /* Write out the [remaining] word. */
218                 for ( ; i < p->col; i++) {
219                         if (vend > bp && jhy > 0 && i > jhy)
220                                 break;
221                         if ('\t' == p->buf[i])
222                                 break;
223                         if (' ' == p->buf[i]) {
224                                 j = i;
225                                 while (' ' == p->buf[i])
226                                         i++;
227                                 dv = (i - j) * (*p->width)(p, ' ');
228                                 vbl += dv;
229                                 vend += dv;
230                                 break;
231                         }
232                         if (ASCII_NBRSP == p->buf[i]) {
233                                 vbl += (*p->width)(p, ' ');
234                                 continue;
235                         }
236
237                         /*
238                          * Now we definitely know there will be
239                          * printable characters to output,
240                          * so write preceding white space now.
241                          */
242                         if (vbl) {
243                                 (*p->advance)(p, vbl);
244                                 p->viscol += vbl;
245                                 vbl = 0;
246                         }
247
248                         if (ASCII_HYPH == p->buf[i]) {
249                                 (*p->letter)(p, '-');
250                                 p->viscol += (*p->width)(p, '-');
251                                 continue;
252                         }
253
254                         (*p->letter)(p, p->buf[i]);
255                         if (8 == p->buf[i])
256                                 p->viscol -= (*p->width)(p, p->buf[i-1]);
257                         else 
258                                 p->viscol += (*p->width)(p, p->buf[i]);
259                 }
260                 vis = vend;
261         }
262
263         /*
264          * If there was trailing white space, it was not printed;
265          * so reset the cursor position accordingly.
266          */
267         if (vis)
268                 vis -= vbl;
269
270         p->col = 0;
271         p->overstep = 0;
272
273         if ( ! (TERMP_NOBREAK & p->flags)) {
274                 p->viscol = 0;
275                 (*p->endline)(p);
276                 return;
277         }
278
279         if (TERMP_HANG & p->flags) {
280                 p->overstep = (int)(vis - maxvis +
281                                 p->trailspace * (*p->width)(p, ' '));
282
283                 /*
284                  * If we have overstepped the margin, temporarily move
285                  * it to the right and flag the rest of the line to be
286                  * shorter.
287                  * If there is a request to keep the columns together,
288                  * allow negative overstep when the column is not full.
289                  */
290                 if (p->trailspace && p->overstep < 0)
291                         p->overstep = 0;
292                 return;
293
294         } else if (TERMP_DANGLE & p->flags)
295                 return;
296
297         /* If the column was overrun, break the line. */
298         if (maxvis < vis + p->trailspace * (*p->width)(p, ' ')) {
299                 (*p->endline)(p);
300                 p->viscol = 0;
301         }
302 }
303
304
305 /* 
306  * A newline only breaks an existing line; it won't assert vertical
307  * space.  All data in the output buffer is flushed prior to the newline
308  * assertion.
309  */
310 void
311 term_newln(struct termp *p)
312 {
313
314         p->flags |= TERMP_NOSPACE;
315         if (p->col || p->viscol)
316                 term_flushln(p);
317 }
318
319
320 /*
321  * Asserts a vertical space (a full, empty line-break between lines).
322  * Note that if used twice, this will cause two blank spaces and so on.
323  * All data in the output buffer is flushed prior to the newline
324  * assertion.
325  */
326 void
327 term_vspace(struct termp *p)
328 {
329
330         term_newln(p);
331         p->viscol = 0;
332         if (0 < p->skipvsp)
333                 p->skipvsp--;
334         else
335                 (*p->endline)(p);
336 }
337
338 void
339 term_fontlast(struct termp *p)
340 {
341         enum termfont    f;
342
343         f = p->fontl;
344         p->fontl = p->fontq[p->fonti];
345         p->fontq[p->fonti] = f;
346 }
347
348
349 void
350 term_fontrepl(struct termp *p, enum termfont f)
351 {
352
353         p->fontl = p->fontq[p->fonti];
354         p->fontq[p->fonti] = f;
355 }
356
357
358 void
359 term_fontpush(struct termp *p, enum termfont f)
360 {
361
362         assert(p->fonti + 1 < 10);
363         p->fontl = p->fontq[p->fonti];
364         p->fontq[++p->fonti] = f;
365 }
366
367
368 const void *
369 term_fontq(struct termp *p)
370 {
371
372         return(&p->fontq[p->fonti]);
373 }
374
375
376 enum termfont
377 term_fonttop(struct termp *p)
378 {
379
380         return(p->fontq[p->fonti]);
381 }
382
383
384 void
385 term_fontpopq(struct termp *p, const void *key)
386 {
387
388         while (p->fonti >= 0 && key < (void *)(p->fontq + p->fonti))
389                 p->fonti--;
390         assert(p->fonti >= 0);
391 }
392
393
394 void
395 term_fontpop(struct termp *p)
396 {
397
398         assert(p->fonti);
399         p->fonti--;
400 }
401
402 /*
403  * Handle pwords, partial words, which may be either a single word or a
404  * phrase that cannot be broken down (such as a literal string).  This
405  * handles word styling.
406  */
407 void
408 term_word(struct termp *p, const char *word)
409 {
410         const char      *seq, *cp;
411         char             c;
412         int              sz, uc;
413         size_t           ssz;
414         enum mandoc_esc  esc;
415
416         if ( ! (TERMP_NOSPACE & p->flags)) {
417                 if ( ! (TERMP_KEEP & p->flags)) {
418                         bufferc(p, ' ');
419                         if (TERMP_SENTENCE & p->flags)
420                                 bufferc(p, ' ');
421                 } else
422                         bufferc(p, ASCII_NBRSP);
423         }
424         if (TERMP_PREKEEP & p->flags)
425                 p->flags |= TERMP_KEEP;
426
427         if ( ! (p->flags & TERMP_NONOSPACE))
428                 p->flags &= ~TERMP_NOSPACE;
429         else
430                 p->flags |= TERMP_NOSPACE;
431
432         p->flags &= ~(TERMP_SENTENCE | TERMP_IGNDELIM);
433
434         while ('\0' != *word) {
435                 if ('\\' != *word) {
436                         if (TERMP_SKIPCHAR & p->flags) {
437                                 p->flags &= ~TERMP_SKIPCHAR;
438                                 word++;
439                                 continue;
440                         }
441                         ssz = strcspn(word, "\\");
442                         encode(p, word, ssz);
443                         word += (int)ssz;
444                         continue;
445                 }
446
447                 word++;
448                 esc = mandoc_escape(&word, &seq, &sz);
449                 if (ESCAPE_ERROR == esc)
450                         break;
451
452                 if (TERMENC_ASCII != p->enc)
453                         switch (esc) {
454                         case (ESCAPE_UNICODE):
455                                 uc = mchars_num2uc(seq + 1, sz - 1);
456                                 if ('\0' == uc)
457                                         break;
458                                 encode1(p, uc);
459                                 continue;
460                         case (ESCAPE_SPECIAL):
461                                 uc = mchars_spec2cp(p->symtab, seq, sz);
462                                 if (uc <= 0)
463                                         break;
464                                 encode1(p, uc);
465                                 continue;
466                         default:
467                                 break;
468                         }
469
470                 switch (esc) {
471                 case (ESCAPE_UNICODE):
472                         encode1(p, '?');
473                         break;
474                 case (ESCAPE_NUMBERED):
475                         c = mchars_num2char(seq, sz);
476                         if ('\0' != c)
477                                 encode(p, &c, 1);
478                         break;
479                 case (ESCAPE_SPECIAL):
480                         cp = mchars_spec2str(p->symtab, seq, sz, &ssz);
481                         if (NULL != cp) 
482                                 encode(p, cp, ssz);
483                         else if (1 == ssz)
484                                 encode(p, seq, sz);
485                         break;
486                 case (ESCAPE_FONTBOLD):
487                         term_fontrepl(p, TERMFONT_BOLD);
488                         break;
489                 case (ESCAPE_FONTITALIC):
490                         term_fontrepl(p, TERMFONT_UNDER);
491                         break;
492                 case (ESCAPE_FONTBI):
493                         term_fontrepl(p, TERMFONT_BI);
494                         break;
495                 case (ESCAPE_FONT):
496                         /* FALLTHROUGH */
497                 case (ESCAPE_FONTROMAN):
498                         term_fontrepl(p, TERMFONT_NONE);
499                         break;
500                 case (ESCAPE_FONTPREV):
501                         term_fontlast(p);
502                         break;
503                 case (ESCAPE_NOSPACE):
504                         if (TERMP_SKIPCHAR & p->flags)
505                                 p->flags &= ~TERMP_SKIPCHAR;
506                         else if ('\0' == *word)
507                                 p->flags |= TERMP_NOSPACE;
508                         break;
509                 case (ESCAPE_SKIPCHAR):
510                         p->flags |= TERMP_SKIPCHAR;
511                         break;
512                 default:
513                         break;
514                 }
515         }
516 }
517
518 static void
519 adjbuf(struct termp *p, size_t sz)
520 {
521
522         if (0 == p->maxcols)
523                 p->maxcols = 1024;
524         while (sz >= p->maxcols)
525                 p->maxcols <<= 2;
526
527         p->buf = mandoc_realloc(p->buf, sizeof(int) * p->maxcols);
528 }
529
530 static void
531 bufferc(struct termp *p, char c)
532 {
533
534         if (p->col + 1 >= p->maxcols)
535                 adjbuf(p, p->col + 1);
536
537         p->buf[p->col++] = c;
538 }
539
540 /*
541  * See encode().
542  * Do this for a single (probably unicode) value.
543  * Does not check for non-decorated glyphs.
544  */
545 static void
546 encode1(struct termp *p, int c)
547 {
548         enum termfont     f;
549
550         if (TERMP_SKIPCHAR & p->flags) {
551                 p->flags &= ~TERMP_SKIPCHAR;
552                 return;
553         }
554
555         if (p->col + 6 >= p->maxcols)
556                 adjbuf(p, p->col + 6);
557
558         f = term_fonttop(p);
559
560         if (TERMFONT_UNDER == f || TERMFONT_BI == f) {
561                 p->buf[p->col++] = '_';
562                 p->buf[p->col++] = 8;
563         }
564         if (TERMFONT_BOLD == f || TERMFONT_BI == f) {
565                 if (ASCII_HYPH == c)
566                         p->buf[p->col++] = '-';
567                 else
568                         p->buf[p->col++] = c;
569                 p->buf[p->col++] = 8;
570         }
571         p->buf[p->col++] = c;
572 }
573
574 static void
575 encode(struct termp *p, const char *word, size_t sz)
576 {
577         size_t            i;
578
579         if (TERMP_SKIPCHAR & p->flags) {
580                 p->flags &= ~TERMP_SKIPCHAR;
581                 return;
582         }
583
584         /*
585          * Encode and buffer a string of characters.  If the current
586          * font mode is unset, buffer directly, else encode then buffer
587          * character by character.
588          */
589
590         if (TERMFONT_NONE == term_fonttop(p)) {
591                 if (p->col + sz >= p->maxcols) 
592                         adjbuf(p, p->col + sz);
593                 for (i = 0; i < sz; i++)
594                         p->buf[p->col++] = word[i];
595                 return;
596         }
597
598         /* Pre-buffer, assuming worst-case. */
599
600         if (p->col + 1 + (sz * 5) >= p->maxcols)
601                 adjbuf(p, p->col + 1 + (sz * 5));
602
603         for (i = 0; i < sz; i++) {
604                 if (ASCII_HYPH == word[i] ||
605                     isgraph((unsigned char)word[i]))
606                         encode1(p, word[i]);
607                 else
608                         p->buf[p->col++] = word[i];
609         }
610 }
611
612 size_t
613 term_len(const struct termp *p, size_t sz)
614 {
615
616         return((*p->width)(p, ' ') * sz);
617 }
618
619 static size_t
620 cond_width(const struct termp *p, int c, int *skip)
621 {
622
623         if (*skip) {
624                 (*skip) = 0;
625                 return(0);
626         } else
627                 return((*p->width)(p, c));
628 }
629
630 size_t
631 term_strlen(const struct termp *p, const char *cp)
632 {
633         size_t           sz, rsz, i;
634         int              ssz, skip, c;
635         const char      *seq, *rhs;
636         enum mandoc_esc  esc;
637         static const char rej[] = { '\\', ASCII_HYPH, ASCII_NBRSP, '\0' };
638
639         /*
640          * Account for escaped sequences within string length
641          * calculations.  This follows the logic in term_word() as we
642          * must calculate the width of produced strings.
643          */
644
645         sz = 0;
646         skip = 0;
647         while ('\0' != *cp) {
648                 rsz = strcspn(cp, rej);
649                 for (i = 0; i < rsz; i++)
650                         sz += cond_width(p, *cp++, &skip);
651
652                 c = 0;
653                 switch (*cp) {
654                 case ('\\'):
655                         cp++;
656                         esc = mandoc_escape(&cp, &seq, &ssz);
657                         if (ESCAPE_ERROR == esc)
658                                 return(sz);
659
660                         if (TERMENC_ASCII != p->enc)
661                                 switch (esc) {
662                                 case (ESCAPE_UNICODE):
663                                         c = mchars_num2uc
664                                                 (seq + 1, ssz - 1);
665                                         if ('\0' == c)
666                                                 break;
667                                         sz += cond_width(p, c, &skip);
668                                         continue;
669                                 case (ESCAPE_SPECIAL):
670                                         c = mchars_spec2cp
671                                                 (p->symtab, seq, ssz);
672                                         if (c <= 0)
673                                                 break;
674                                         sz += cond_width(p, c, &skip);
675                                         continue;
676                                 default:
677                                         break;
678                                 }
679
680                         rhs = NULL;
681
682                         switch (esc) {
683                         case (ESCAPE_UNICODE):
684                                 sz += cond_width(p, '?', &skip);
685                                 break;
686                         case (ESCAPE_NUMBERED):
687                                 c = mchars_num2char(seq, ssz);
688                                 if ('\0' != c)
689                                         sz += cond_width(p, c, &skip);
690                                 break;
691                         case (ESCAPE_SPECIAL):
692                                 rhs = mchars_spec2str
693                                         (p->symtab, seq, ssz, &rsz);
694
695                                 if (ssz != 1 || rhs)
696                                         break;
697
698                                 rhs = seq;
699                                 rsz = ssz;
700                                 break;
701                         case (ESCAPE_SKIPCHAR):
702                                 skip = 1;
703                                 break;
704                         default:
705                                 break;
706                         }
707
708                         if (NULL == rhs)
709                                 break;
710
711                         if (skip) {
712                                 skip = 0;
713                                 break;
714                         }
715
716                         for (i = 0; i < rsz; i++)
717                                 sz += (*p->width)(p, *rhs++);
718                         break;
719                 case (ASCII_NBRSP):
720                         sz += cond_width(p, ' ', &skip);
721                         cp++;
722                         break;
723                 case (ASCII_HYPH):
724                         sz += cond_width(p, '-', &skip);
725                         cp++;
726                         break;
727                 default:
728                         break;
729                 }
730         }
731
732         return(sz);
733 }
734
735 /* ARGSUSED */
736 size_t
737 term_vspan(const struct termp *p, const struct roffsu *su)
738 {
739         double           r;
740
741         switch (su->unit) {
742         case (SCALE_CM):
743                 r = su->scale * 2;
744                 break;
745         case (SCALE_IN):
746                 r = su->scale * 6;
747                 break;
748         case (SCALE_PC):
749                 r = su->scale;
750                 break;
751         case (SCALE_PT):
752                 r = su->scale / 8;
753                 break;
754         case (SCALE_MM):
755                 r = su->scale / 1000;
756                 break;
757         case (SCALE_VS):
758                 r = su->scale;
759                 break;
760         default:
761                 r = su->scale - 1;
762                 break;
763         }
764
765         if (r < 0.0)
766                 r = 0.0;
767         return(/* LINTED */(size_t)
768                         r);
769 }
770
771 size_t
772 term_hspan(const struct termp *p, const struct roffsu *su)
773 {
774         double           v;
775
776         v = ((*p->hspan)(p, su));
777         if (v < 0.0)
778                 v = 0.0;
779         return((size_t) /* LINTED */
780                         v);
781 }