Re: F39 proposal: Man-pages-ru Retirement (Self-Contained Change proposal)

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Off Topic

I have been developing C code with Fedora for about 20 years.  I know by heart, the usual such as stdlib, malloc, ... etc.
But on occasion, when I see some code with a typo for the type definition    (example misspelled.h).
 
I would like to be able to enter   "man.stdio.h"  or "man ctype.h" or "man whatever.h"   etc, and get the include file abbreviated content  listing.  As an example, man stdio yields very very little info. Neither does "man stdio.h"

As I see it, "man whatever.h" should be the table of contents for the "whatever.h" include file include file,  but I can get a listing of what is therein.  I have to go to /usr/include to do my top level research.
  
As a developer, and I believe, other developers who use C, C++, Rust,  etc, I would like to do a man  "whatever.h" to optain a list of the defines, and from that list, I would choose to select  the entry for which I need more information.

Please give some thought to the programmer sitting at a terminal and who is debugging someone else's code.  



Leslie Satenstein    



On Thursday, April 27, 2023 at 02:22:21 p.m. EDT, Ben Cotton <bcotton@xxxxxxxxxx> wrote:


https://fedoraproject.org/wiki/Changes/ManPagesRuRetirement

This document represents a proposed Change. As part of the Changes
process, proposals are publicly announced in order to receive
community feedback. This proposal will only be implemented if approved
by the Fedora Engineering Steering Committee.


== Summary ==
Retiring man-pages-ru because it is already part of the man-pages-l10n.


== Owner ==
* Name: [[User:ljavorsk| Lukas Javorsky]]
* Email: ljavorsk@xxxxxxxxxx


== Detailed Description ==
Upstream (man-pages-l10n) has integrated Russian translations for
man-pages. It means we no longer need to have a specific
(man-pages-ru) package for it.
[https://salsa.debian.org/manpages-l10n-team/manpages-l10n/-/commit/37b44f5a8ad3999501c79a20b67a27e17cc65630
Upstream commit containing the change]

The plan is simple:
1) Deprecate man-pages-ru package

2) Enable 'ru' translations for man-pages-l10n (temporary disabled due
to conflicts). [https://src.fedoraproject.org/rpms/man-pages-l10n/c/00a88c237e1fd7cdef9c52665128b155cf14243c?branch=rawhide
Commit disabling it]
Also add Obsolete and Provides for man-pages-ru package.


== Feedback ==
Early feedback from the community is positive, the feedback is located
in this  ([https://lists.fedoraproject.org/archives/list/devel@xxxxxxxxxxxxxxxxxxxxxxx/thread/WGLMJ7XXB5JUER57GEOZQBFMNKHD5FSZ/
Devel list announce])

== Benefit to Fedora ==
Fedora shouldn't maintain a redundant package. This change would make
it easier for the maintainer as well as for the packages that requires
man-pages-l10n and man-pages-ru.

== Scope ==
* Proposal owners: Package man-pages-ru will be retired, and the
man-pages-l10n will contain the Russian translations.

* Other developers: Change the names of their BuildRequires/Requires
accordingly.

* Release engineering: No action required

* Policies and guidelines: N/A (not needed for this Change)

* Trademark approval: N/A (not needed for this Change)


* Alignment with Objectives:

== Upgrade/compatibility impact ==
When following the plan in Detailed Description there will be no need
for manual action. Everything will be handled by the automated dnf
upgrade.


== How To Test ==


== User Experience ==


== Dependencies ==
List of the packages from Fedora 39

=== man-pages-ru ===
dnf repoquery --whatrequires man-pages-ru | pkgname
<empty>

dnf repoquery --whatrequires '/usr/share/man/ru/*' | pkgname
<empty>


== Contingency Plan ==
* Contingency mechanism: Remove the man-pages-l10n build with Russian
translation enabled. Revert deprecation of the man-pages-ru package.
* Contingency deadline: Beta freeze
* Blocks release? No

''NOTE: If we don't finish this change by the deadline, it is possible
to just complete this change with the next release.''


== Documentation ==
[https://salsa.debian.org/manpages-l10n-team/manpages-l10n/-/commit/37b44f5a8ad3999501c79a20b67a27e17cc65630
Upstream issue]
[https://bugzilla.redhat.com/show_bug.cgi?id=2163421 Bugzilla tracker]
[https://sourceforge.net/p/man-pages-ru/discussion/1102373/thread/7dda92a232/
man-pages-l10n upstream discussion with man-pages-ru upstream about
this]

== Release Notes ==


--
Ben Cotton
He / Him / His
Fedora Program Manager
Red Hat
TZ=America/Indiana/Indianapolis
_______________________________________________
devel mailing list -- devel@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe send an email to devel-leave@xxxxxxxxxxxxxxxxxxxxxxx
Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: https://lists.fedoraproject.org/archives/list/devel@xxxxxxxxxxxxxxxxxxxxxxx
Do not reply to spam, report it: https://pagure.io/fedora-infrastructure/new_issue
_______________________________________________
devel mailing list -- devel@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe send an email to devel-leave@xxxxxxxxxxxxxxxxxxxxxxx
Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: https://lists.fedoraproject.org/archives/list/devel@xxxxxxxxxxxxxxxxxxxxxxx
Do not reply to spam, report it: https://pagure.io/fedora-infrastructure/new_issue

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Index of Archives]     [Fedora Announce]     [Fedora Users]     [Fedora Kernel]     [Fedora Testing]     [Fedora Formulas]     [Fedora PHP Devel]     [Kernel Development]     [Fedora Legacy]     [Fedora Maintainers]     [Fedora Desktop]     [PAM]     [Red Hat Development]     [Gimp]     [Yosemite News]

  Powered by Linux