259815 – Missing documentation in perl-module.eclass, perl-app.eclass

Bug 259815 - Missing documentation in perl-module.eclass, perl-app.eclass

Summary: Missing documentation in perl-module.eclass, perl-app.eclass

Status:	RESOLVED FIXED

Alias:	None

Product:	Gentoo Linux
Classification:	Unclassified
Component:	Eclasses (show other bugs)
Hardware:	All Linux

Importance:	High enhancement (vote)
Assignee:	Gentoo Perl team

URL:
Whiteboard:
Keywords:

Depends on:
Blocks:	perl-eclass
	Show dependency tree

Reported:	2009-02-21 15:10 UTC by Torsten Veller (RETIRED)
Modified:	2014-11-15 21:11 UTC (History)
CC List:	5 users (show)

See Also:
Package list:
Runtime testing required:	---

Attachments
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 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 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 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.