Bug 259815

Summary:	Missing documentation in perl-module.eclass, perl-app.eclass
Product:	Gentoo Linux	Reporter:	Torsten Veller (RETIRED) <tove>
Component:	Eclasses	Assignee:	Gentoo Perl team <perl>
Status:	RESOLVED FIXED
Severity:	enhancement	CC:	binki, dilfridge, esigra, hasufell, monsieurp
Priority:	High
Version:	unspecified
Hardware:	All
OS:	Linux
Whiteboard:
Package list:		Runtime testing required:	---
Bug Depends on:
Bug Blocks:	239510

Description Torsten Veller (RETIRED) gentoo-dev

2009-02-21 15:10:39 UTC

perl-module.eclass and perl-app.eclass miss app-portage/eclass-manpages processible documentation.

Comment 1 Julian Ospald 2012-11-30 22:08:11 UTC

yeah

Comment 2 Patrice Clement (RETIRED) gentoo-dev

2014-11-02 19:26:15 UTC

Andreas K. Huettel (dilfridge) and I have decided to take on this task. We will post our progress in this bug report.

Comment 3 Patrice Clement (RETIRED) gentoo-dev

2014-11-15 21:11:34 UTC

All functions in perl-module.eclass have been documented. Each function has now a header with:
- @FUNCTION describing the function name
- @USAGE describing how to use the function
- @DESCRIPTION explaining roughly how to use the function

I've also discussed with dilfridge and added TODO items here and there in the file. We need to move some code around and get rid of some since there are redundant functions (perl-module_pkg_postinst and perl_link_duallife_scripts). We should probably open a bug for this task.

I don't think there's any item left as far as the documentation is concerned so I'm closing this bug.