Bug 33654

Summary: openssl(1) contains many broken SEE ALSO references
Product: Documentation Reporter: rdm <rdm>
Component: Books & ArticlesAssignee: freebsd-bugs (Nobody) <bugs>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description rdm 2002-01-07 19:20:00 UTC
        The SEE ALSO list in the openssl(1) man page contains many
        references to pages which are not in the distribution, as:

	  asn1parse(1), ca(1), config(5), crl(1), crl2pkcs7(1), dgst(1), 
          dhparam(1), dsa(1), dsaparam(1), enc(1), gendsa(1), genrsa(1), 
          nseq(1), pkcs12(1), pkcs7(1), pkcs8(1), rand(1), req(1), rsa(1), 
          rsautl(1), s_client(1), s_server(1), smime(1), spkac(1), 
          verify(1), version(1), x509(1), crypto(3), ssl(3)

Fix: 

Dunno; remove the links, flag them, or add the pages.
How-To-Repeat: 
        % man openssl
Comment 1 Giorgos Keramidas 2002-01-08 07:45:25 UTC
On 2002-01-07 11:12:34, Rich Morin wrote:
>
> >Description:
>
>         The SEE ALSO list in the openssl(1) man page contains many
>         references to pages which are not in the distribution, as:
>
> 	  asn1parse(1), ca(1), config(5), crl(1), crl2pkcs7(1), dgst(1),
>           dhparam(1), dsa(1), dsaparam(1), enc(1), gendsa(1), genrsa(1),
>           nseq(1), pkcs12(1), pkcs7(1), pkcs8(1), rand(1), req(1), rsa(1),
>           rsautl(1), s_client(1), s_server(1), smime(1), spkac(1),
>           verify(1), version(1), x509(1), crypto(3), ssl(3)

This is probably not a real problem, since in the sample make.conf
file at /usr/share/examples/etc/make.conf you will find among other
things the following:

  # To build the OpenSSL manpages, uncomment the following.  These are not
  # built by default because they clobber a number of system manpages with
  # manpages describing parts of the OpenSSL toolkit, including passwd(1),
  # err(3), md5(3), and others.
  #
  #WANT_OPENSSL_MANPAGES= true

- Giorgos
Comment 2 dd freebsd_committer freebsd_triage 2002-02-10 22:15:42 UTC
Responsible Changed
From-To: freebsd-doc->kris

Over to maintainer. 
Kris, I think this should just be closed, but that should probably be your 
decision to make.
Comment 3 Nicolas Rachinsky 2002-04-01 23:47:04 UTC
Since docs/36629 is considered a duplicate of this PR, I want to add,
that there should be a possibility to get the openssl manpages without
loosing system manpages.

I submitted a partial fix to achieve this with docs/36629.

Nicolas
Comment 4 Kris Kennaway freebsd_committer freebsd_triage 2002-08-24 04:57:44 UTC
State Changed
From-To: open->suspended
Comment 5 Kris Kennaway freebsd_committer freebsd_triage 2003-01-17 02:26:58 UTC
Responsible Changed
From-To: kris->freebsd-bugs

I am no longer the openssl maintainer
Comment 6 Tom Rhodes freebsd_committer freebsd_triage 2003-02-25 15:56:12 UTC
State Changed
From-To: suspended->closed

nectar has recently created a knob which installs the OpenSSL manual pages.  Thanks!