zsh-workers
 help / color / mirror / code / Atom feed
* Zsh online manuals under SunOS 5.7.
@ 1999-07-19 19:18 Tanaka Akira
  1999-07-20  5:27 ` Tanaka Akira
  0 siblings, 1 reply; 3+ messages in thread
From: Tanaka Akira @ 1999-07-19 19:18 UTC (permalink / raw)
  To: zsh-workers

Under SunOS 5.7, if windex is generated by /bin/catman -w, man command
cannot refer zsh online manuals.

Z:akr@is27e1u11% cd Doc 
Z:akr@is27e1u11% mkdir man
Z:akr@is27e1u11% cd man
Z:akr@is27e1u11% mkdir man1
Z:akr@is27e1u11% cp ../zsh.1 man1/zsh.1
Z:akr@is27e1u11% MANPATH=$PATH man zsh |head -10
No manual entry for zsh.
Z:akr@is27e1u11% ls
man1
Z:akr@is27e1u11% MANPATH=$PWD man zsh |head -10 
Reformatting page.  Wait... done



User Commands                                              ZSH(1)



 NAME
     zsh - the Z shell

Broken Pipe
Z:akr@is27e1u11% catman -w -M $PWD       
Z:akr@is27e1u11% MANPATH=$PWD man zsh    
No manual entry for zsh.
Z:akr@is27e1u11% ls -l windex
-rw-r--r--   1 akr      is             0 Jul 20 04:08 windex
Z:akr@is27e1u11% vi man1/zsh.1

Edit man1/zsh.1 as follows:

| --- man1/zsh.1-	Mon Jul 19 23:56:34 1999
| +++ man1/zsh.1	Tue Jul 20 03:53:10 1999
| @@ -1,11 +1,7 @@
| -.TH "ZSH" "1" "July 19, 1999" "zsh 3\&.1\&.6\-test\-2"
| +.TH "ZSH" "1" "July 19, 1999"
|  .SH ""NAME
| -.'
|  zsh \- the Z shell
| -.' (avoiding a yodl bug)
|  .\" Yodl file: Zsh/intro.yo
| -.'
| -.'
|  .SH ""SYNOPSIS
|  .'
|  Because zsh contains many features, the zsh manual has been split into

Z:akr@is27e1u11% catman -w -M $PWD
Z:akr@is27e1u11% ls -l windex
-rw-r--r--   1 akr      is            28 Jul 20 04:10 windex
Z:akr@is27e1u11% cat windex
zsh             zsh (1)         - the Z shell
Z:akr@is27e1u11% MANPATH=$PWD man zsh |head -10 
Reformatting page.  Wait... done



User Commands                                              ZSH(1)



 NAME
     zsh - the Z shell

Broken Pipe
Z:akr@is27e1u11% 

Because man command under SunOS 5.7 uses windex to search a manual
file, empty windex causes the "No manual entry for zsh." error.

Is there a way to make online manuals suitable for Solaris 7 catman?
# without editing by hand.
-- 
Tanaka Akira


^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: Zsh online manuals under SunOS 5.7.
  1999-07-19 19:18 Zsh online manuals under SunOS 5.7 Tanaka Akira
@ 1999-07-20  5:27 ` Tanaka Akira
  1999-07-20  8:20   ` Peter Stephenson
  0 siblings, 1 reply; 3+ messages in thread
From: Tanaka Akira @ 1999-07-20  5:27 UTC (permalink / raw)
  To: zsh-workers

In article <rsq908czbw4.fsf@crane.jaist.ac.jp>,
  Tanaka Akira <akr@jaist.ac.jp> writes:

> Under SunOS 5.7, if windex is generated by /bin/catman -w, man command
> cannot refer zsh online manuals.

I tried to make workaround for this problem.
At least, following patch fix the problem under SunOS 5.7.

--- Doc/Makefile.in-	Tue Jul 20 13:26:03 1999
+++ Doc/Makefile.in	Tue Jul 20 14:24:07 1999
@@ -83,7 +83,7 @@
 	  */*) target=$@ ;; \
 	  *) target=$(sdir)/$@ ;; \
 	esac; \
-	$(YODL) -o $$target -I$(sdir) -w zman.yo version.yo $< || exit 1; \
+	$(YODL) -I$(sdir) -w zman.yo version.yo $< | sed -e '1s/\\-/-/g' -e '/^\.SH ""NAME/,/^\.SH ""/ { /^\.'\''/d; }' > $$target || exit 1; \
 	test -f $$target
 
 zsh_us.ps: zsh.dvi
@@ -100,7 +100,7 @@
 	  */*) target=$@ ;; \
 	  *) target=$(sdir)/$@ ;; \
 	esac; \
-	$(YODL) -o $$target -I$(sdir) -DZSHALL -w zman.yo version.yo zsh.yo || exit 1; \
+	$(YODL) -I$(sdir) -DZSHALL -w zman.yo version.yo zsh.yo | sed -e '1s/\\-/-/g' -e '/^\.SH ""NAME/,/^\.SH ""/ { /^\.'\''/d; }' > $$target || exit 1; \
 	test -f $$target
 
 ../META-FAQ: META-FAQ.yo Zsh/metafaq.yo
-- 
Tanaka Akira


^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: Zsh online manuals under SunOS 5.7.
  1999-07-20  5:27 ` Tanaka Akira
@ 1999-07-20  8:20   ` Peter Stephenson
  0 siblings, 0 replies; 3+ messages in thread
From: Peter Stephenson @ 1999-07-20  8:20 UTC (permalink / raw)
  To: zsh-workers

Tanaka Akira wrote:
> > Under SunOS 5.7, if windex is generated by /bin/catman -w, man command
> > cannot refer zsh online manuals.
> 
> I tried to make workaround for this problem.
> At least, following patch fix the problem under SunOS 5.7.

OK, but it seems to me we might as well delete all the .' lines, which I
think are just there to work around a yodl bug.  And me might as well
work around the other bug, that sections are printed as ""NAME.

This is all with yodl 1.22.  I can't find a newer version.

--- Doc/Makefile.in.yobug	Tue Jul 20 09:32:53 1999
+++ Doc/Makefile.in	Tue Jul 20 10:02:06 1999
@@ -83,7 +83,7 @@
 	  */*) target=$@ ;; \
 	  *) target=$(sdir)/$@ ;; \
 	esac; \
-	$(YODL) -I$(sdir) -w zman.yo version.yo $< | sed -e '1s/\\-/-/g' -e '/^\.SH ""NAME/,/^\.SH ""/ { /^\.'\''/d; }' > $$target || exit 1; \
+	$(YODL) -I$(sdir) -w zman.yo version.yo $< | sed -e '1s/\\-/-/g' -e '/^\.'\''/d' > $$target || exit 1; \
 	test -f $$target
 
 zsh_us.ps: zsh.dvi
@@ -100,7 +100,7 @@
 	  */*) target=$@ ;; \
 	  *) target=$(sdir)/$@ ;; \
 	esac; \
-	$(YODL) -I$(sdir) -DZSHALL -w zman.yo version.yo zsh.yo | sed -e '1s/\\-/-/g' -e '/^\.SH ""NAME/,/^\.SH ""/ { /^\.'\''/d; }' > $$target || exit 1; \
+	$(YODL) -I$(sdir) -DZSHALL -w zman.yo version.yo zsh.yo | sed -e '1s/\\-/-/g' -e '/^\.'\''/d' > $$target || exit 1; \
 	test -f $$target
 
 ../META-FAQ: META-FAQ.yo Zsh/metafaq.yo
--- Doc/zman.yo.yobug	Sat Jun 12 15:47:20 1999
+++ Doc/zman.yo	Tue Jul 20 10:00:16 1999
@@ -61,8 +61,9 @@
 
 def(chapter)(1)(CMT())
 
+COMMENT(--- the "" works around a yodl bug ---)
 def(sect)(1)(\
-  NOTRANS(.SH ")UPPERCASE(ARG1)(0)"NL()\
+  NOTRANS(.SH )UPPERCASE(ARG1)(0)""NL()\
   STDPAR()\
   CMT()\
 )

-- 
Peter Stephenson <pws@ibmth.df.unipi.it>       Tel: +39 050 844536
WWW:  http://www.ifh.de/~pws/
Dipartimento di Fisica, Via Buonarroti 2, 56127 Pisa, Italy


^ permalink raw reply	[flat|nested] 3+ messages in thread

end of thread, other threads:[~1999-07-20  8:51 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
1999-07-19 19:18 Zsh online manuals under SunOS 5.7 Tanaka Akira
1999-07-20  5:27 ` Tanaka Akira
1999-07-20  8:20   ` Peter Stephenson

Code repositories for project(s) associated with this public inbox

	https://git.vuxu.org/mirror/zsh/

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).