From Fedora Project Wiki

< FWN‎ | Beats

(→‎Features Policy Modified: clarify Features section wording)
(FWN#153 Devel beat pass 1)
Line 7: Line 7:
Contributing Writer: [[OisinFeeley|Oisin Feeley]]
Contributing Writer: [[OisinFeeley|Oisin Feeley]]


=== Features Policy Modified ===
=== More and Wider Testing ===


The latest FESCo discussions (2008-11-12) clarified[1] the Features[2] process. The changes make explicit the need for testing to be complete one week prior to the final freeze. Failure to meet that condition can result in FESCo deciding to drop the feature or implement a contingency plan or other suitable action.
In a thoughtful post [[CallumLerwick|Callum Lerwick]] suggested[1] that <code>Fedora</code> testing coverage could be improved in several inter-related areas. These included making <code>Bugzilla</code> easier to use; adding per-package rollbacks to enable reversion to known good states; blocking <code>yum</code> updates on specific reported bugs; providing a rescue image in <code>/boot</code> with the aforementioned functionality; and lastly, enabling simple installation of specific updates which might fix said reported bugs. Callum asked for respondents to eschew what he called the "Hard problem fallacy" which consisted of minor technical objections and asked them to provide answers modeled on the pattern of "You are an idiot and your ideas are stupid. We're not doing this."


[1] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00847.html
[1] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01370.html


[2] Features are "a significant change or enhancement to the version of Fedora currently under development": http://fedoraproject.org/wiki/Features/Policy/Definitions
On the subject of rollbacks [[JefSpaleta|Jef Spaleta]] objected[2] that it was complicated by the triggered scripts in packages. Currently there are no tests for rollback and Jef wondered "...how do you set up a test which attempts to measure whether rollback across a trigger boundary put you back to where you were? How much of a different in state counts as 'break rollback' ?" He then added the problem of <code>Obsoletes:</code> "When an obsolete is introduced in an update... can we rollback and get what we had?" He finished off with the suggestion that ''Carrier Grade Linux'' might have some experience to offer as they had attempted rollbacks. [[SethVidal|Seth Vidal]] remembered[3] that "[...] the rollback functionality the CGL wanted was removed from rpm recently." [[GilboaDavra|Gilboa Davra]] asked[4] how it would be possible to pin-point what exactly had broken when there was a "150 package update push. Will you rollback all the updates? Only the updates that had _something_ to do with the breakage?" RalfCorsepius also nixed[5] the idea as "[...] package rollbacks will never work in general, because updates may contain non-reversable statefull operations (e.g. reformatting databases)."


The spur to these discussions was several last-minute changes for Fedora 10 which included dropping the instant-messaging client Empathy as the default, and the late addition of LiveConnect (see FWN#151[3]) and AMQP[4]. Earlier confusion about the Feature process and difficulties with communication had also been expressed (see FWN#147[5]) after the decision to drop the Lightweight X11 Desktop Environment as a feature.
[2] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01394.html


[3] http://fedoraproject.org/wiki/FWN/Issue151#LiveConnect_Feature_Approved_for_Fedora_10
[3] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01396.html


[4] The Advanced Messaging Queue Protocol is a vendor-neutral middleware transport for business processes: http://en.wikipedia.org/wiki/Advanced_Message_Queuing_Protocol
[4] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01409.html


[5] http://fedoraproject.org/wiki/FWN/Issue147#LXDE_Feature_Removal_Disappointment_-_How_to_Avoid
[5] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01442.html


The other major changes to the process include the emailing of the Feature owner to inform them when their feature is being discussed by FESCo and any decisions made concerning said feature. The extra work involved in tracking down email addresses was anticipated to be an over-burdening of the committee chair, [[BrianPepple|Brian Pepple]]. To ease this problem it was decided that Feature owners must include current email addresses on their Feature pages.
A comprehensive reply was made[6] by [[GilboaDavra|Gilboa Davra]]. In it he argued that automating bug reports lowered the signal-to-noise ratio considerable and objected to modification of yum to refuse updates until reported bugs are fixed: "Say-what?!? Are we building a second Vista here?" Although he liked the idea of a rescue image in <code>/boot</code> he cautioned that space considerations impinged upon the need to keep "[...] a different rescue image for each installed kernel unless you plan to keep the original kernel[.]" As regards selective updates he stated: "You can always enable updates-testing and selectively install what you need."


=== Server SIG ===
[6] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01409.html


DanHorák announced[1] that a "[...] formal entity to coordinate [...] the server fundamentals that later create a successful enterprise product [...]" had been launched as a SIG. He invited constructive ideas and the wiki page[2] suggests that the SIG has many important initial goals including: a spin for headless servers, CLI equivalents of GUI tools, a lightweight installer and maintenance of the <code>/etc/sysconfig/network-scripts</code>.
A preliminary step was added[7] by [[ChrisLumens|Chris Lumens]] to those listed by Callum: "I'd like to add a step (0) before we make bugs easier to file and really crank up the number of reports we're getting: (0) More people FIXING the bug, not just reporting them. You can have a giant user base of people filing tons of bugs, and you can have a motivated and effective QA/Triaging team whittling them down to the really important and reproducable bugs. But without more people fixing them, the backlog is just going to continue to build."


[1] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00645.html
[7] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01421.html


[2] https://fedoraproject.org/wiki/DanHorak/ServerSIG
When [[PeterLemenkov|Peter Lemenkov]] wondered[8] why users were forced to register on <code>Bugzilla</code> [[BillNottingham|Bill Nottingham]] underscored[9] the need for tools which do not swamp developers with large numbers of bugs. [[AlanCox|Alan Cox]] added[10] that the key was "[...] one clear and accurate bug report that happens to contain the right information and the user willing to help." [[DanielBerrange|Daniel P. Berrange]] further explained[11] that "[...] 90% [of bugs] are essentially useless when first reported. It requires several back/forth interactions between myself & the bug reporter to get enough information to diagnose & resolve the problem. If we create a system where we bombard maintainers with bugreports & no scope for user interaction they'll end up directly in /dev/null, and further discourage maintainers from addressing even bugs with enough info."


The extensive discussion which followed mostly consisted of approval for the idea. [[DennisGilmore|Dennis Gilmore]] expressed[3] enthusiasm for the general idea and specifically requested kickstart files for different types of servers and "best practice" whitepapers. An example of one of the issues the SIG might deal with was[4] the observation by [[ChrisAdams|Chris Adams]] that an installation of <code>ntop</code> had resulted in seventy dependencies, including <code>metacity</code>, being pulled down. [[PeterRobinson|Peter Robinson]] attributed[5] this to <code>graphviz</code> and suggested that while such problems were declining in number it would be useful for the ServerSIG to co-ordinate bug filing for these issues. Chris provided[6] a script which allowed test installs into a subdirectory to determine "what gets pulled in." Later [[JamesAntill|James Antill]] mentioned two useful scripts written by himself and [[SethVidal|Seth Vidal]] which show package dependencies and provides as a tree structure. [[DominikMierzejewski|Dominik "rathan" Mierzejewski]] added[7] a mention of <code>rpmreaper</code>, a utility which eases the removal of unnecessary dependencies.
[8] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01408.html


[3] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00652.html
[9] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01399.html


[4] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00730.html
[10] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01415.html


[5] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00736.html
[11] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01422.html


[6] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00778.html
The ''Ubuntu'' tool <code>apport</code> was discussed[12] as a possible solution several times as was[13] the ''Debian'' tool <code>reportbug</code>.


[7] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00932.html
[12] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01428.html


After Chris observed that "[w]ith rawhide, it appears impossible to install a kernel without pulling in X libraries (because of plymouth), so I guess the base X libraries can be considered "core" now" the conversation took a more adversarial turn. The accuracy of this statement turned out[8] to depend on whether <code>libpng</code> and <code>pango</code> were considered to be "X libraries" and Chris demonstrated the dependency chain as originating with the <code>plymouth-plugin-solar</code>. [[LesMikesell|Les Mikesell]] commented[9]: "This is all pretty strange from a server perspective. And plymouth is there to keep the screen from blinking while you boot?" When [[JesseKeating|Jesse Keating]] replied that Plymouth "handl[ed] the passphrase prompting for encrypted volumes" Les argued[10] that it should be optional for remote, headless boxes. [[DominikMierzejewski|Dominik "rathann" Mierzejewski]] was shocked[11] when [[JesseKeating|Jesse Keating]] pointed out that <code>plymouth</code> also provided working <code>/var/log/boot.log</code>s: " Hm, you're right, all my boot.log files are 0 bytes (F-9). So instead of fixing the bug, a new package was introduced? Amazing." Dominik's dissatisfaction continued[12] to be unabated when he was informed that the absence of the kernel commandline parameter "rhgb" would result in <code>plymouthd</code> running but without any graphical plugins.
[13] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01456.html


[8] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00787.html
An emphasis was placed[14] on providing Bugzilla tools for developers and packagers by [[JamesAntill|James Antill]]: "I won't mind getting 666 dups, or dealing with 10x as many bugs in general, as long as I have a decent local tool that can manage that number of bugs. Atm lots of TABs of open bugs, and giant folders of BZ email are the best tools I've seen."


[9] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00787.html
[14] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01492.html


[10] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00795.html
[[KarelZak|KarelZak]] jumped[15] straight to the original question and answered that testing participation was low "[...] because this work is not attractive. It's boring work without proper credit in open source community. It's very simple to found list of top-ten kernel developers, but who knows the most active bug reporters or QA around kernel? Nobody. People who are testing a software are real contributors. Our THANKS to them should be more visible!"


[11] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00814.html
[15] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01696.html


[12] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00859.html
=== Source File Audit Catches RPM Problems Early ===


The automatic selection of <code>plymouth-plugin-solar</code> as opposed to the alternate "plymouth-text-and-details-only" resulted[13] in a discussion around whether it was possible to make <code>yum</code> behave differently in such ambiguous situations. [[EnricoScholz|Enrico Scholz]] wished to add a "fail, warn and/or prompt when multiple packages satisfy a (virtual) dependency[.]" [[SethVidal|Seth Vidal]] reminded[14] him that the constraint of non-interactive defaults meant that this might not work. [[JamesAntill|James Antill]] posted[15] that he had a patch to <code>yum</code> which "[...] would allow Fedora (or any active repo.) to configure these choices manually. We could then also easily have different defaults for the desktop vs. the server spins." James received some questions from [[JesseKeating|Jesse Keating]] and [[BillNottingham|Bill Nottingham]] who asked how per-spin defaults would be stored and how to deal with conflicting information from multiple repositories. His answer suggested[16] that introducing new repositories for the metadata or changing its syntax would be necessary.
[[KevinFenzi|Kevin Fenzi]] posted[1] the results from the latest run of his sources/patches URL checker script. There were 912 possible problems reported, which Kevin noted was "Up from 662 last run. This is a pretty sad increase."


[13] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00858.html
[1] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01433.html


[14] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00907.html
Happily many of the reported problems appeared[2] to be due to either temporary problems with ''GoogleCode'' and ''SourceForge'' project hosting or to some minor oddities in the script. Many of the other highlighted problems were confirmed as genuine and fixed by the package owners.


[15] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00995.html
[2] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01450.html


[16] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01030.html
[[IanWeller|Ian Weller]] contrasted[3] a successful run of <code>spectool -g</code>[4], which uses <code>wget</code> internally, with the failure of Kevin's script. Later Kevin also found[5] a similar result when examining another failure. He speculated "[...] it's working fine with a wget... perhaps they are blocking the agent that spectool -g uses? (which I am not sure what it reports)." [[VilleSkyttä|Ville Skyttä]] offered[6] that "spectool -g uses plain wget, with configuration file /etc/fedora/wgetrc if it exists, otherwise usual system wget configs" and [[ThomasMoschny|Thomas Moschny]] discovered[7] that "spectool uses -N, which seems to cause 404 errors with googlecode[.]" [[JaroslavReznik|Jaroslav Reznik]] confirmed[8] this: "Same for me - it's not working for googlecode downloads. Wget with -N param sends HEAD instead GET - these two are same, but HEADs response are only headers - it's used for links validation etc... But looks is it misconfiguration on server side?" and thanked Kevin for the usefulness of his script which had caught a serious problem.


[[DanHorák|Dan Horák's]] desire to remove <code>plymouth</code> entirely was dismissed[17] as non-optional by [[BillNottingham|Bill Nottingham]] as it will take on an even more important role in storage handling in the future. Bill suggested that the default plugin was optional however. He reassured[18] Dan that as regards headless machines there had been "[...] some testing on PPC boxes via serial/hvc consoles. Please test that it works in your scenarios as well, of course." When [[EnricoScholz|Enrico Scholz]] rejected disk encryption as important for servers [[JesseKeating|Jesse Keating]] made[19] the case that "In a colo environment I /would/ want some encryption on the disk, and if I have to use a remote kvm to input the passphrase at reboot time, that's OK. Reboots are either planned events, or emergencies, both of which are going to require the attention of the people who have the passphrase." [[AlanCox|Alan Cox]] backed[20] this up: "If you are storing personal data on a system in a colo its practically mandatory to have encryption, and if you are storing anything sensitive its a big deal indeed - at least in those parts of the world with real data and privacy law ;)"
[3] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01434.html


[17] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00784.html
[4] The spectool utility is part of <code>rpmdevtools</code>. It downloads and extracts sources and patches to build RPMs


[18] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00792.html
[5] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01451.html


[19] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00798.html
[6] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01454.html


[20] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00823.html
[7] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01459.html


The thread continued in fits and starts. [[AdamTkac|Adam Tkac]] raised[21] the problem of handling static IPs with <code>NetworkManager</code> (see this same FWN#152 "NetworkManager keyfiles for Pre-login Static Routes" for a discussion of as yet undocumented features). [[ChuckAnderson|Chuck Anderson]] disputed[22] that the problem existed and provided commandline and GUI solutions: "[...] for system-wide connections which you would presumably want for a server, you edit /etc/sysconfig/networkscripts/ifcfg-* as usual and NM will bring the interface up at boot. From the desktop, you can Edit Connections and create a new static connection and select it instead of the System or Auto connection which is very handy when moving between networks that don't support DHCP."
[[EricSandeen|Eric Sandeen]] asked[9] if it would be a good idea to extend <code>rpmlint</code> to perform these checks: "I'm most likely to fix this stuff if I'm in the middle of making some other change, and an automatic check while I'm working on a package that says `hey your source URL is no longer valid' would probably provoke me to fix it quickly. :)"


An important addendum was provided[23] by [[OlivierGalibert|Olivier Galibert]] "Try a "chkconfig -list network". It should be on for levels 2-5. If it isn't, you haven't enabled the old-style networking [.]" The same point was made by Chuck[24] "Are you using NetworkManager or network service? chkconfig -list NetworkManager; chkconfig -list network If NetworkManager is enabled and network is not, then you need to change ifcfg-eth0: NM_CONTROLLED=yes" and by [[BillNottingham|Bill Nottingham]][25] "You need to either set NM_CONTROLLED to something other than 'no', or enable the 'network' service. In either case, NM's static network support is not your problem."
[8] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01466.html


[21] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00863.html
[9] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01641.html


[22] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00871.html
=== One Issue Tracker to Rule Them All ===


[23] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00892.html
[[ArthurPemberton|Arthur Pemberton]] examined[1] the challenge issued by [[CallumLerwick|Callum Lerwick]] to improve <code>Bugzilla</code> (see this same FWN#153 "More and Wider Testing".) He asked for a list features which distinguished <code>Bugzilla</code> from competitors.


[24] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00887.html
[1] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01430.html


[25] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00938.html
The ability of <code>Bugzilla</code> to deal with a massive number of "products, components, users, hits per second [with] clustering databases and similar magic" was advanced[2] by [[MatejCepl|Matej Cepl]] as the most compelling reason. [[NicolasMailhot|Nicholas Mailhot]] added[3] "feature completeness, familiar UI, integrating with upstream issue trackers (which are often bugzilla too)" and [[EmmanuelSeyman|Emmanuel Seyman]] suggested[4]: "And as an encore : it has to contain 109900+ bugs of existing data so that we don't lose any history."


The LSB[26] also came in for a bashing due to infrequently used, old tools (such as <code>ypbind</code> and the insecure r-commands) being installed to achieve compliance. [[PatriceDumas|Patrice Dumas]] clarified[27] that <code>ypbind</code> was necessary in <code>@base</code> to provide <code>NIS</code> functionality. Later discussion separated[28] out LSB-Core and LSB-Desktop which should simplify making a minimal install LSB compliant. [[BillNottingham|Bill Nottingham]] and [[ChrisAdams|Chris Adams]] performed[29] a dissection of <code>@core</code> with the intent of separating out items such as <code>hdparm</code> , <code>prelink</code> , <code>dhclient</code> , <code>ed</code> and others into <code>@base</code>.
[2] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01470.html


[26] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00718.html
[3] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01477.html


[27] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00753.html
[4] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01483.html


[28] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00759.html
A certain amount of impatience with the general idea was expressed[5] by [[MatejCepl|Matej Cepl]] when he agreed with [[AndrewCagney|Andrew Cagney]] that one essential feature would be a "push upstream" button: "AMEN!!! And I think we should concentrate on this rather than doing stupid bugzilla rewrites. Sorry, for being harsh, but it is so IMNSHO." [[EmmanuelSeyman|Emmanuel Seyman]] warned[6] that it would be necessary to map users, bugs and components across any separate upstream/downstream instances of bugzilla. He later expanded[7] upon this: "Bugzilla has gained the abilty to customize statuses and resolutions, making it even harder to push bugs from one bugzilla to another with prompting for user interaction." <code>LaunchPad</code>[8] was discussed[9] as possibly providing this feature. [[CaseyDahlin|Casey Dahlin]] noted[10] that cross-site integration was still not implemented "[...] because there should never ever ever be two independent sets of launchpad data ever, according to their philosophy [.]"


[29] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00802.html
[5] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01611.html


[[JeremyKatz|Jeremy Katz]] outlined[30][31] a perspective from the Quality Assurance point of view. The burden imposed by preserving the modularity that many of the participants advocated sounds quite high: "[...] trying to preserve that modularity combinatorially adds to the testing matrix and also makes it significantly more difficult to write code since you can no longer depend on functionality. It also makes things slower as you have to conditionally check for things constantly [...] It's more than just /etc/init.d/network that has to be maintained. There's oodles of stuff in install-time configuration that will have to be maintained, tested, and have things fixed when people report them." [[SethVidal|Seth Vidal]] acknowledged[32] this but cautioned against dismissing the objections to particular changes as merely "neoluddite".
[6] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01615.html


[30] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01023.html
[7] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01622.html


[31] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01025.html
[8] Canonical's collaborative hosting service https://launchpad.net/


[32] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01027.html
[9] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01616.html


The massive thread included much more discussion and resists easy summary. Those interested should probably plow through the messages. Among the issues raised were finding DBus documentation[33] and contention between class devices to set default routes[34].
[10] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01539.html


A quote from DanHorak which seems to offer the perspective of the ServerSIG concisely is appropriate in closing: "It is really time to look back at the roots of Unix systems. It should be a combination of small pieces with well defined interfaces doing well their tasks. Only the time had changed those pieces from simple command line utilities to more complex ones."
[[TillMaas|Till Maas]] suggested[11] several interesting improvements including "[...] the possibility of having several people beeing responsible for a Component, which is currently only partly possible. There is the initial CC list, but when a bug is reassigned to a different component, the members of the initial CC list of the old component are not removed from the list." Other desiderata included storing the <code>NEVR</code> of a package in a dedicated field and support for the same bug across several different releases.


[33] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01071.html
[11] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01612.html


[34] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00911.html
The issue of how bugs can actually be fixed cropped up again in the discussion. [[BrennanAshton|Brennan Ashton]] suggested[12] that triaging bugs was an area in need of volunteers and provided a link[13] to the [[BugZappers]] wiki page.


=== NetworkManager keyfiles for Pre-login Static Routes ===
[12] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01704.html


In the course of the ServerSIG discussions (see this same FWN#152 "Server SIG") an interesting question about <code>NetworkManager</code> was asked[1] by [[LesMikesell|Les Mikesell]]: "If you bring up a mix of static and dynamically assigned interfaces, can you control which gets to assign the default route and DNS servers?"
[13] https://fedoraproject.org/wiki/BugZappers


[1] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00872.html
=== RFC: Fix Summary Text for Lots of Packages ===


[[DanWilliams|Dan Williams]] provided[2] a useful description of how <code>NetworkManager</code> currently decides the default route. In response to [[OlivierGalibert|Olivier Galibert]] he added[3] that static routes could be set up using the "[...] connection editor see the "Routes..." button in the IPv4 tab. Routes from ifcfg files aren't yet supported, but could be. Routes from keyfile-based system connections (ie, prelogin) are supported." After this tidbit [[ChuckAnderson|Chuck Anderson]] prodded[4] Dan into explaining that keyfiles were a way to support things like "VPN, 3G, WPA" which were difficult or impossible to support with the ifcfg files in <code>/etc/sysconfig/network-scripts</code>. "NM has a system settings 'keyfile' plugin that allows editing system connections from the connection editor, or your favorite text editor if you don't use a GUI at all. Add `,keyfile' to the --plugins argument in the /usr/share/dbus-1/systemservices/org.freedesktop.NetworkManagerSystemSettings.service file, and then 'killall -TERM nm-system-settings'."
[[RichardHughes|Richard Hughes]] wished[1] that the Packaging Guidelines on summaries and descriptions would be followed a little more closely as "[q]uite a lot of packages have summary text that is overly verbose, and this makes the GUI and output from pkcon look rubbish."


[2] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00880.html
[1] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01484.html  


[3] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00897.html
[[JoshBoyer|Josh Boyer]] warned[2] against making reviewers' jobs harder by codifying too much in the package guidelines and suggested: "Just file bugs for packages you think are overly verbose. Offer alternate summaries in the bug, and a URL to your email for rationale." [[BillNottingham|Bill Nottingham]] was[3] dubious that "[...] this scales across 5000 packages. So it would be good to have at least *something* in the guidelines." When Richard compromised on a "soft guideline such as: Summary should aim to be less than 8 words" [[DavidWoodhouse|David Woodhouse]] gently poked[4] fun at this summary as being too wordy.


[4] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00900.html
[2] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01487.html


[[JesseKeating|Jesse Keating]] wondered when and where the documentation for this was placed and Dan replied[5] "[w]hen I struggle up for air from the tarpit that is the concurrent release of NM 0.7 + F10 + RHEL 5.3? :) "
[3] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01489.html


[5] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00912.html
[4] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01493.html


=== Flash 10 in 64-bit Fedora 9 ===
[[ToshioKuratomi|Toshio Kuratomi]] expressed[5] disapproval of soft guidelines due to their potential for sparking many individual disagreements instead of one single point of contention being handled by the Packaging Committee. Richard seemed happy enough with Toshio's suggestion[6] that the packaging guidelines contain a "best practice" description with examples.


[[JosVos|Jos Vos]] asked[1] for comparative data on using <code>nspluginwrapper</code> with <code>Firefox</code> to access <code>Flash</code> content in 64-bit Fedora 9. He was experiencing "[...] error messages about not finding 'soundwrapper' in my $PATH [.]"
[5] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01495.html


[1] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00432.html
[6] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01499.html


Although [[ChrisAdams|Chris Adams]] reported success [[OrcanOgetbil|Orcan Ogetbil]] described[2] a "gray rectangle bug" which seemed to be manifested mostly when multiple tabs were open. [[BrennanAshton|Brennan Ashton]] claimed[3] that it was due to a <code>PulseAudio</code> "bug".
When [[BillNottingham|Bill Nottingham]] raised[7] the possibility of "summary collisions" [[JefSpaleta|Jef Spaleta]] threw out[8] an analogy based on searching for medicine in a grocery store in a foreign country. This was intended to stimulate clarification of the function of summaries. [[ToshioKuratomi|Toshio Kuratomi]] loved[9] it and suggested that summaries were like the "[...] little advertising gimicks seen on and alongside the other things on the bottle. Things like: "New!", "Larger size", [Picture of grapes and smiling child], etc. They're differentiators that "help" you choose one product over another." He provided some concrete examples which seemed to prove his case.


[2] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00439.html
[7] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01520.html


[3] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00443.html
[8] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01536.html
 
[[IgnacioVazquez-Abrams|Ignacio Vazquez-Abrams]] and others reported[4] no problems and Jos posted[5] that there appeared to be a dependency on <code>libcurl.i386</code> in the Adobe supplied <code>rpm</code>. This was later stated[6] by [[PaulHowarth|Paul Howarth]] to be changed so that either <code>libcurl.so.3</code> or <code>libcurl.so.4</code> will be used via a <code>dlopen()</code> and there is no explicit <code>requires:libcurl</code> in the rpm. [[GianlucaSzforna|Gianluca Szforna]] supplied[7] a link[8] which suggests that <code>libflashsupport</code> should be completely removed as it may cause crashes.


[4] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00437.html
[9] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01569.html


[5] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00445.html
[[MichalHlavinka|Michal Hlavinka]] worried[10] that <code>yum search <keyword></code> would be disrupted but [[MichaelSchwendt|Michael Schwendt]] re-assured[11] him that "'yum search' also searches the package %description. And the description is the place where to be much more verbose than in the summary. The %summary is not made for searching, but for enabling the installer and packaging tools to to display a brief and concise package description or a list thereof. That means, put a few relevant keywords in the summary (newspaper headline-style at most), but avoid long/complete sentences as often as possible. That also makes it easier to fit into one line."


[6] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00479.html
[10] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01500.html


[7] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg00484.html
[11] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01510.html


[8] http://macromedia.mplug.org/
Later Richard asked[12] for opinions on a sample email which he intended to send out to some maintainers to alert them to their long package summaries.
 
[12] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01640.html
 
 
[[AndreaMusuruane|Andrea Musuruane]], as an ''RPM Fusion'' packager, felt[13] that packagers' time would be wasted in following the proposal and that a "Summary is something that the packager should choose on his own. It must be less than 80 characters and _maybe_ it should not contain the package name. Everything else is just marketing. If someone thinks that adding the fact that the application is based on Gnome, it is fine for me. If someone else thinks that mentioning that other application uses DBUS it is fine for me too." Richard clarified[14]: "I'm _not_ saying "change your summary or we'll drop your package" I'm asking them to come into line with 90% of the other packages in the distro. I'm even offering to do the cvs commit myself, if they give me the new summary line."
[13] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01654.html
 
[14] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01656.html
 
The issue of these changes being made solely to accommodate <code>PackageKit</code> was addressed[15] by [[JamesAntill|James Antill]]: "The fact that a single tool decided that summaries should be used instead of names, and so summaries should be roughly the same size of names shouldn't make Fedora packages break their summaries for other tools ... all IMO." When [[EmmanuelSeyman|Emmanuel Seyman]] asked[16] exactly how GUI packaging tools made the summary more prominent than the package name [[RichardHughes|Richard Hughes]] responded[17] that it was actually one, but one that was exposed in many places. Emmanuel's response was blunt: "FWIW, I don't appreciate our maintainers being lied to. The vast majority of them work hard to make their packages and I believe that a minimum of respect should be shown [...] it is a case of changing one application versus changing 500." [[VilleSkyttä|Ville Skyttä]] took[18] an overview which left the current user-interface of <code>gnome-PackageKit</code> aside and concentrated on whether there was agreement that <code>rpmlint</code> should be taught to check that the package name should not be repeated in the summary.
 
[15] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01683.html
 
[16] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01672.html
 
[17] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01713.html
 
[18] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01673.html
 
Further criticism was made[19] by [[ChristopherWickert|Christopher Wickert]] of sorting packages by description instead of name in PackageKit and [[TomLane|Tom Lane]] raised[20] the problem of sub-packages needing to reference the name of their parent package. At this stage it seemed that some consensus had been reached on the idea that summaries which repeated the program name were frowned upon and that "verb phrases" should be also be deprecated as suggested[21] by [[IgnacioVazquezAbrams|Ignacio Vazquez-Abrams]].
 
[19] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01721.html
 
[20] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01733.html
 
[21] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01532.html
 
A brief dispute between [[AndreaMusuruane|Andreas Musuruane]] and [[MichaelSchwendt|Michael Schwendt]] yielded a closing statement which seemed[22] to make the case of those that favor the changes in a strong manner. Michael accepted that: "[i]t isn't trivial to come up with good one-line summaries that do more than repeating the program name. It's nothing packagers like to spend time on. Reducing a packager's freedom even further won't be a good thing [...] I think with some people one could argue endlessly about pkg summaries. And during pkg reviews that's wasted time. Still, with very old repositories it has been noticed [and agreed on, mostly] that some types of summaries simply look poor in Anaconda and package management tools. That was the rationale for some of the recommendations." RichardHughes noted[23] that over the last forty-eight hours many maintainers had changed their package summaries as requested.
 
[22] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01753.html
 
[23] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01764.html
 
=== Smock: Simpler Smock for Chain Building ===
 
A couple of announcements were made by [[RichardJones|Richard Jones]]. The first was of a new version of <code>OCaml</code>. The second was[1] of a wrapper script that "[...] runs on top of mock, allowing you to chain-build a series of RPMs from a single command." An example which would "[...] arrange the SRPMs into the correct order according to their BuildRequires, then build each in the four separate mock environments Fedora {9,10} {i386,x86_64}" was provided:
 
<pre>smock.pl --arch=i386 --arch=x86_64 \
--distro=fedora-9 --distro=fedora-10 \
*.src.rpm
</pre>
 
[1] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01229.html
 
[[TillMaas|Till Maas]] suggested[2] that local file access URIs[3], such as <code>file:///</code>, could be used to avoid the need for a webserver and [[PaulHowarth|Paul Howarth]] confirmed[4] that he had been using mock "[...] like this for *years* with loopback-mounted ISO images for a low-cost source for the base repo. It definitely works."
 
[2] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01232.html
 
[3] See RFC1738 section 3.10 http://tools.ietf.org/html/rfc1738
 
[4] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01264.html
 
[[SethVidal|Seth Vidal]] asked[5] why the wrapper approach had been taken instead of integrating the functionality into <code>mock</code> and Richard agreed[6] that this should happen. An initial problem with build requires of the form "%{name}-devel" failing was quickly fixed[7].
 
[5] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01238.html
 
[6] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01239.html
 
[7] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01354.html

Revision as of 21:36, 23 November 2008

Developments

In this section the people, personalities and debates on the @fedora-devel mailing list are summarized.

Contributing Writer: Oisin Feeley

More and Wider Testing

In a thoughtful post Callum Lerwick suggested[1] that Fedora testing coverage could be improved in several inter-related areas. These included making Bugzilla easier to use; adding per-package rollbacks to enable reversion to known good states; blocking yum updates on specific reported bugs; providing a rescue image in /boot with the aforementioned functionality; and lastly, enabling simple installation of specific updates which might fix said reported bugs. Callum asked for respondents to eschew what he called the "Hard problem fallacy" which consisted of minor technical objections and asked them to provide answers modeled on the pattern of "You are an idiot and your ideas are stupid. We're not doing this."

[1] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01370.html

On the subject of rollbacks Jef Spaleta objected[2] that it was complicated by the triggered scripts in packages. Currently there are no tests for rollback and Jef wondered "...how do you set up a test which attempts to measure whether rollback across a trigger boundary put you back to where you were? How much of a different in state counts as 'break rollback' ?" He then added the problem of Obsoletes: "When an obsolete is introduced in an update... can we rollback and get what we had?" He finished off with the suggestion that Carrier Grade Linux might have some experience to offer as they had attempted rollbacks. Seth Vidal remembered[3] that "[...] the rollback functionality the CGL wanted was removed from rpm recently." Gilboa Davra asked[4] how it would be possible to pin-point what exactly had broken when there was a "150 package update push. Will you rollback all the updates? Only the updates that had _something_ to do with the breakage?" RalfCorsepius also nixed[5] the idea as "[...] package rollbacks will never work in general, because updates may contain non-reversable statefull operations (e.g. reformatting databases)."

[2] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01394.html

[3] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01396.html

[4] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01409.html

[5] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01442.html

A comprehensive reply was made[6] by Gilboa Davra. In it he argued that automating bug reports lowered the signal-to-noise ratio considerable and objected to modification of yum to refuse updates until reported bugs are fixed: "Say-what?!? Are we building a second Vista here?" Although he liked the idea of a rescue image in /boot he cautioned that space considerations impinged upon the need to keep "[...] a different rescue image for each installed kernel unless you plan to keep the original kernel[.]" As regards selective updates he stated: "You can always enable updates-testing and selectively install what you need."

[6] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01409.html

A preliminary step was added[7] by Chris Lumens to those listed by Callum: "I'd like to add a step (0) before we make bugs easier to file and really crank up the number of reports we're getting: (0) More people FIXING the bug, not just reporting them. You can have a giant user base of people filing tons of bugs, and you can have a motivated and effective QA/Triaging team whittling them down to the really important and reproducable bugs. But without more people fixing them, the backlog is just going to continue to build."

[7] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01421.html

When Peter Lemenkov wondered[8] why users were forced to register on Bugzilla Bill Nottingham underscored[9] the need for tools which do not swamp developers with large numbers of bugs. Alan Cox added[10] that the key was "[...] one clear and accurate bug report that happens to contain the right information and the user willing to help." Daniel P. Berrange further explained[11] that "[...] 90% [of bugs] are essentially useless when first reported. It requires several back/forth interactions between myself & the bug reporter to get enough information to diagnose & resolve the problem. If we create a system where we bombard maintainers with bugreports & no scope for user interaction they'll end up directly in /dev/null, and further discourage maintainers from addressing even bugs with enough info."

[8] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01408.html

[9] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01399.html

[10] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01415.html

[11] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01422.html

The Ubuntu tool apport was discussed[12] as a possible solution several times as was[13] the Debian tool reportbug.

[12] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01428.html

[13] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01456.html

An emphasis was placed[14] on providing Bugzilla tools for developers and packagers by James Antill: "I won't mind getting 666 dups, or dealing with 10x as many bugs in general, as long as I have a decent local tool that can manage that number of bugs. Atm lots of TABs of open bugs, and giant folders of BZ email are the best tools I've seen."

[14] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01492.html

KarelZak jumped[15] straight to the original question and answered that testing participation was low "[...] because this work is not attractive. It's boring work without proper credit in open source community. It's very simple to found list of top-ten kernel developers, but who knows the most active bug reporters or QA around kernel? Nobody. People who are testing a software are real contributors. Our THANKS to them should be more visible!"

[15] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01696.html

Source File Audit Catches RPM Problems Early

Kevin Fenzi posted[1] the results from the latest run of his sources/patches URL checker script. There were 912 possible problems reported, which Kevin noted was "Up from 662 last run. This is a pretty sad increase."

[1] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01433.html

Happily many of the reported problems appeared[2] to be due to either temporary problems with GoogleCode and SourceForge project hosting or to some minor oddities in the script. Many of the other highlighted problems were confirmed as genuine and fixed by the package owners.

[2] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01450.html

Ian Weller contrasted[3] a successful run of spectool -g[4], which uses wget internally, with the failure of Kevin's script. Later Kevin also found[5] a similar result when examining another failure. He speculated "[...] it's working fine with a wget... perhaps they are blocking the agent that spectool -g uses? (which I am not sure what it reports)." Ville Skyttä offered[6] that "spectool -g uses plain wget, with configuration file /etc/fedora/wgetrc if it exists, otherwise usual system wget configs" and Thomas Moschny discovered[7] that "spectool uses -N, which seems to cause 404 errors with googlecode[.]" Jaroslav Reznik confirmed[8] this: "Same for me - it's not working for googlecode downloads. Wget with -N param sends HEAD instead GET - these two are same, but HEADs response are only headers - it's used for links validation etc... But looks is it misconfiguration on server side?" and thanked Kevin for the usefulness of his script which had caught a serious problem.

[3] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01434.html

[4] The spectool utility is part of rpmdevtools. It downloads and extracts sources and patches to build RPMs

[5] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01451.html

[6] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01454.html

[7] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01459.html

Eric Sandeen asked[9] if it would be a good idea to extend rpmlint to perform these checks: "I'm most likely to fix this stuff if I'm in the middle of making some other change, and an automatic check while I'm working on a package that says `hey your source URL is no longer valid' would probably provoke me to fix it quickly. :)"

[8] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01466.html

[9] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01641.html

One Issue Tracker to Rule Them All

Arthur Pemberton examined[1] the challenge issued by Callum Lerwick to improve Bugzilla (see this same FWN#153 "More and Wider Testing".) He asked for a list features which distinguished Bugzilla from competitors.

[1] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01430.html

The ability of Bugzilla to deal with a massive number of "products, components, users, hits per second [with] clustering databases and similar magic" was advanced[2] by Matej Cepl as the most compelling reason. Nicholas Mailhot added[3] "feature completeness, familiar UI, integrating with upstream issue trackers (which are often bugzilla too)" and Emmanuel Seyman suggested[4]: "And as an encore : it has to contain 109900+ bugs of existing data so that we don't lose any history."

[2] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01470.html

[3] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01477.html

[4] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01483.html

A certain amount of impatience with the general idea was expressed[5] by Matej Cepl when he agreed with Andrew Cagney that one essential feature would be a "push upstream" button: "AMEN!!! And I think we should concentrate on this rather than doing stupid bugzilla rewrites. Sorry, for being harsh, but it is so IMNSHO." Emmanuel Seyman warned[6] that it would be necessary to map users, bugs and components across any separate upstream/downstream instances of bugzilla. He later expanded[7] upon this: "Bugzilla has gained the abilty to customize statuses and resolutions, making it even harder to push bugs from one bugzilla to another with prompting for user interaction." LaunchPad[8] was discussed[9] as possibly providing this feature. Casey Dahlin noted[10] that cross-site integration was still not implemented "[...] because there should never ever ever be two independent sets of launchpad data ever, according to their philosophy [.]"

[5] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01611.html

[6] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01615.html

[7] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01622.html

[8] Canonical's collaborative hosting service https://launchpad.net/

[9] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01616.html

[10] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01539.html

Till Maas suggested[11] several interesting improvements including "[...] the possibility of having several people beeing responsible for a Component, which is currently only partly possible. There is the initial CC list, but when a bug is reassigned to a different component, the members of the initial CC list of the old component are not removed from the list." Other desiderata included storing the NEVR of a package in a dedicated field and support for the same bug across several different releases.

[11] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01612.html

The issue of how bugs can actually be fixed cropped up again in the discussion. Brennan Ashton suggested[12] that triaging bugs was an area in need of volunteers and provided a link[13] to the BugZappers wiki page.

[12] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01704.html

[13] https://fedoraproject.org/wiki/BugZappers

RFC: Fix Summary Text for Lots of Packages

Richard Hughes wished[1] that the Packaging Guidelines on summaries and descriptions would be followed a little more closely as "[q]uite a lot of packages have summary text that is overly verbose, and this makes the GUI and output from pkcon look rubbish."

[1] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01484.html

Josh Boyer warned[2] against making reviewers' jobs harder by codifying too much in the package guidelines and suggested: "Just file bugs for packages you think are overly verbose. Offer alternate summaries in the bug, and a URL to your email for rationale." Bill Nottingham was[3] dubious that "[...] this scales across 5000 packages. So it would be good to have at least *something* in the guidelines." When Richard compromised on a "soft guideline such as: Summary should aim to be less than 8 words" David Woodhouse gently poked[4] fun at this summary as being too wordy.

[2] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01487.html

[3] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01489.html

[4] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01493.html

Toshio Kuratomi expressed[5] disapproval of soft guidelines due to their potential for sparking many individual disagreements instead of one single point of contention being handled by the Packaging Committee. Richard seemed happy enough with Toshio's suggestion[6] that the packaging guidelines contain a "best practice" description with examples.

[5] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01495.html

[6] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01499.html

When Bill Nottingham raised[7] the possibility of "summary collisions" Jef Spaleta threw out[8] an analogy based on searching for medicine in a grocery store in a foreign country. This was intended to stimulate clarification of the function of summaries. Toshio Kuratomi loved[9] it and suggested that summaries were like the "[...] little advertising gimicks seen on and alongside the other things on the bottle. Things like: "New!", "Larger size", [Picture of grapes and smiling child], etc. They're differentiators that "help" you choose one product over another." He provided some concrete examples which seemed to prove his case.

[7] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01520.html

[8] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01536.html

[9] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01569.html

Michal Hlavinka worried[10] that yum search <keyword> would be disrupted but Michael Schwendt re-assured[11] him that "'yum search' also searches the package %description. And the description is the place where to be much more verbose than in the summary. The %summary is not made for searching, but for enabling the installer and packaging tools to to display a brief and concise package description or a list thereof. That means, put a few relevant keywords in the summary (newspaper headline-style at most), but avoid long/complete sentences as often as possible. That also makes it easier to fit into one line."

[10] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01500.html

[11] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01510.html

Later Richard asked[12] for opinions on a sample email which he intended to send out to some maintainers to alert them to their long package summaries.

[12] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01640.html


Andrea Musuruane, as an RPM Fusion packager, felt[13] that packagers' time would be wasted in following the proposal and that a "Summary is something that the packager should choose on his own. It must be less than 80 characters and _maybe_ it should not contain the package name. Everything else is just marketing. If someone thinks that adding the fact that the application is based on Gnome, it is fine for me. If someone else thinks that mentioning that other application uses DBUS it is fine for me too." Richard clarified[14]: "I'm _not_ saying "change your summary or we'll drop your package" I'm asking them to come into line with 90% of the other packages in the distro. I'm even offering to do the cvs commit myself, if they give me the new summary line."

[13] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01654.html

[14] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01656.html

The issue of these changes being made solely to accommodate PackageKit was addressed[15] by James Antill: "The fact that a single tool decided that summaries should be used instead of names, and so summaries should be roughly the same size of names shouldn't make Fedora packages break their summaries for other tools ... all IMO." When Emmanuel Seyman asked[16] exactly how GUI packaging tools made the summary more prominent than the package name Richard Hughes responded[17] that it was actually one, but one that was exposed in many places. Emmanuel's response was blunt: "FWIW, I don't appreciate our maintainers being lied to. The vast majority of them work hard to make their packages and I believe that a minimum of respect should be shown [...] it is a case of changing one application versus changing 500." Ville Skyttä took[18] an overview which left the current user-interface of gnome-PackageKit aside and concentrated on whether there was agreement that rpmlint should be taught to check that the package name should not be repeated in the summary.

[15] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01683.html

[16] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01672.html

[17] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01713.html

[18] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01673.html

Further criticism was made[19] by Christopher Wickert of sorting packages by description instead of name in PackageKit and Tom Lane raised[20] the problem of sub-packages needing to reference the name of their parent package. At this stage it seemed that some consensus had been reached on the idea that summaries which repeated the program name were frowned upon and that "verb phrases" should be also be deprecated as suggested[21] by Ignacio Vazquez-Abrams.

[19] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01721.html

[20] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01733.html

[21] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01532.html

A brief dispute between Andreas Musuruane and Michael Schwendt yielded a closing statement which seemed[22] to make the case of those that favor the changes in a strong manner. Michael accepted that: "[i]t isn't trivial to come up with good one-line summaries that do more than repeating the program name. It's nothing packagers like to spend time on. Reducing a packager's freedom even further won't be a good thing [...] I think with some people one could argue endlessly about pkg summaries. And during pkg reviews that's wasted time. Still, with very old repositories it has been noticed [and agreed on, mostly] that some types of summaries simply look poor in Anaconda and package management tools. That was the rationale for some of the recommendations." RichardHughes noted[23] that over the last forty-eight hours many maintainers had changed their package summaries as requested.

[22] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01753.html

[23] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01764.html

Smock: Simpler Smock for Chain Building

A couple of announcements were made by Richard Jones. The first was of a new version of OCaml. The second was[1] of a wrapper script that "[...] runs on top of mock, allowing you to chain-build a series of RPMs from a single command." An example which would "[...] arrange the SRPMs into the correct order according to their BuildRequires, then build each in the four separate mock environments Fedora {9,10} {i386,x86_64}" was provided:

smock.pl --arch=i386 --arch=x86_64 \
	--distro=fedora-9 --distro=fedora-10 \
	*.src.rpm

[1] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01229.html

Till Maas suggested[2] that local file access URIs[3], such as file:///, could be used to avoid the need for a webserver and Paul Howarth confirmed[4] that he had been using mock "[...] like this for *years* with loopback-mounted ISO images for a low-cost source for the base repo. It definitely works."

[2] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01232.html

[3] See RFC1738 section 3.10 http://tools.ietf.org/html/rfc1738

[4] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01264.html

Seth Vidal asked[5] why the wrapper approach had been taken instead of integrating the functionality into mock and Richard agreed[6] that this should happen. An initial problem with build requires of the form "%{name}-devel" failing was quickly fixed[7].

[5] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01238.html

[6] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01239.html

[7] https://www.redhat.com/archives/fedora-devel-list/2008-November/msg01354.html