Bug 226915 - [NEW PORT] textproc/c2man: allow building GNU FriBidi from a git snapshot
Summary: [NEW PORT] textproc/c2man: allow building GNU FriBidi from a git snapshot
Status: Closed FIXED
Alias: None
Product: Ports & Packages
Classification: Unclassified
Component: Individual Port(s) (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Only Me
Assignee: Li-Wen Hsu
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2018-03-25 15:47 UTC by Ting-Wei Lan
Modified: 2018-05-06 12:38 UTC (History)
1 user (show)

See Also:

Attachments
shell archive of c2man port (3.36 KB, text/plain)
2018-03-25 15:47 UTC, Ting-Wei Lan 		no flags Details
shell archive of c2man port, with deprecated set (3.42 KB, text/plain)
2018-04-16 14:57 UTC, Ting-Wei Lan 		no flags Details
Show Obsolete (1) View All Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Ting-Wei Lan 2018-03-25 15:47:28 UTC 
Created attachment 191803 [details]
shell archive of c2man port

c2man is an obsolete and unmaintained documentation tool that extracts comments
from C source code. Do not use this tool in new projects. The only reason for it
to exist in FreeBSD ports is to allow building GNU FriBidi from a git snapshot.

I am not sure whether we can have an abandoned program added to FreeBSD ports. Getting c2man work on FreeBSD did take me a few hours, so I thought it would be nice to have it in FreeBSD ports to save time of people who need to build GNU FriBidi from git.
Comment 1 Mark Linimon freebsd_committer freebsd_triage 2018-03-25 16:45:46 UTC 
IMHO this should have a "DEPRECATED= not recommended for new projects" line, if it is added.
Comment 2 Ting-Wei Lan 2018-03-26 13:29:49 UTC 
(In reply to Mark Linimon from comment #1)
The porter handbook says 'DEPRECATED' is used to mark for removal, but I hope I can keep c2man in ports until FriBidi migrates off c2man ...
Comment 3 Mark Linimon freebsd_committer freebsd_triage 2018-03-29 04:46:49 UTC 
(In reply to Ting-Wei Lan from comment #2)

Well it also says

"It is possible to set DEPRECATED without an EXPIRATION_DATE (for instance, recommending a newer version of the port), but the converse does not make any sense."

which is what should apply here.  I agree the wording is suboptimal.
Comment 4 Ting-Wei Lan 2018-04-16 14:57:58 UTC 
Created attachment 192562 [details]
shell archive of c2man port, with deprecated set

Sorry for the delay. This is the updated version with DEPRECATED set to remind users that using it is not recommended except for building fribidi.
Comment 5 commit-hook freebsd_committer freebsd_triage 2018-05-06 12:31:44 UTC 
A commit references this bug:

Author: lwhsu
Date: Sun May  6 12:31:03 UTC 2018
New revision: 469196
URL: https://svnweb.freebsd.org/changeset/ports/469196

Log:
  Add c2man, tool to generate documentation from C source code comments

  Add with DEPRECATED but without EXPIRATION_DATE because it is not recommended
  for use in new projects.  We still add this port because there is needed for
  building GNU FriBidi from git snapshot.

  PR:		226915
  Submitted by:	Ting-Wei Lan <lantw44@gmail.com>

Changes:
  head/textproc/Makefile
  head/textproc/c2man/
  head/textproc/c2man/Makefile
  head/textproc/c2man/distinfo
  head/textproc/c2man/files/
  head/textproc/c2man/files/patch-grammar.y
  head/textproc/c2man/files/patch-lex.l
  head/textproc/c2man/pkg-descr