Bug 221873

Summary: Review Request: cgdb - A curses-based interface to the GNU Debugger (GDB)
Product: [Fedora] Fedora Reporter: Gilboa Davara <gilboad>
Component: Package ReviewAssignee: Mamoru TASAKA <mtasaka>
Status: CLOSED NEXTRELEASE QA Contact: Fedora Package Reviews List <fedora-package-review>
Severity: medium Docs Contact:
Priority: medium    
Version: rawhideCC: mtasaka
Target Milestone: ---   
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2007-01-16 17:54:44 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On:    
Bug Blocks: 163779    

Description Gilboa Davara 2007-01-08 17:24:01 UTC
Spec URL: http://gilboadavara.thecodergeek.com/cgdb.spec
SRPM URL: http://gilboadavara.thecodergeek.com/cgdb-0.6.3-1.src.rpm

Description:
CGDB is a curses-based interface to the GNU Debugger (GDB).
The goal of CGDB is to be lightweight and responsive; not encumbered with
unnecessary features.
The interface is designed to deliver the familiar GDB text interface,
with a split screen showing the source as it executes.
The UI is modeled on the classic Unix text editor, vi.
Those familiar with vi should feel right at home using CGDB.

Many thanks to Mr. Peter Gordon for hosting the files.

- Gilboa

Comment 1 Gilboa Davara 2007-01-08 18:44:06 UTC
Oh... forgot to add.
First submission to -extras. Be gentle ;)

rpmlint output:
$ rpmlint -i cgdb-0.6.3-1.fc6.x86_64.rpm
W: cgdb non-coherent-filename cgdb-0.6.3-1.fc6.x86_64.rpm
The file which contains the package should be named
<NAME>-<VERSION>-<RELEASE>.<ARCH>.rpm.

0.6.3 is the version.
-1 is the release.
fc6 is the... well, fc6.
x86_64 is the arch.

What am I missing?


Comment 2 Gilboa Davara 2007-01-08 18:53:50 UTC
Oops rpmlint ran on the binary package. My bad.

$ rpmlint -i cgdb-0.6.3-1.src.rpm
W: cgdb mixed-use-of-spaces-and-tabs (spaces: line 1, tab: line 12)
The specfile mixes use of spaces and tabs for indentation, which is a
cosmetic annoyance.  Use either spaces or tabs for indentation, not both.

Cleared the spaces.
Spec URL: http://gilboadavara.thecodergeek.com/cgdb.spec
SRPM URL: http://gilboadavara.thecodergeek.com/cgdb-0.6.3-2.src.rpm

After fix:
$ rpmlint -i cgdb-0.6.3-2.src.rpm
$

- Gilboa

Comment 3 Karol Trzcionka 2007-01-08 19:24:50 UTC
You should add the FE-NEEDSPONSOR block (177841) in all Your request (before You
are sponsored), but in this request I added it.
I can make a official review, but I can advise you:
"strip $RPM_BUILD_ROOT/%{_bindir}/cgdb" probably is not needed, because (if I
have good information) the rpmbuild does standard stripping.
In %doc You must include:
-AUTHORS
-ChangeLog
-COPYING
-NEWS
-README
-TODO
Now, You are including only REAME.
I did not checked all "MUST/SHOULD", but it was not an official review.
And the last:
E: cgdb-debuginfo empty-debuginfo-package
Empty debuginfo is useless

Comment 4 Gilboa Davara 2007-01-08 20:36:14 UTC
Spec URL: http://gilboadavara.thecodergeek.com/cgdb.spec
SRPM URL: http://gilboadavara.thecodergeek.com/cgdb-0.6.3-3.src.rpm

0.6.3-3:
- Fix %doc.
- Do not strip debug info; let rpm do it.


Comment 5 Mamoru TASAKA 2007-01-09 17:26:24 UTC
Just by glancing at your spec file:

* BuildRequires:
---------------------------------------
BuildRequires:	autoconf
BuildRequires:	automake
BuildRequires:	texinfo
--------------------------------------
  Why are these needed? Mockbuild succeeds without these.

* Requires:
---------------------------------------
Requires:        ncurses
---------------------------------------
  is not needed because dependencies for libraries pulls
  this dependency automatically, long as cgdb is correctly
  linked against ncurses library.

* Directories/files ownership issue
  %{_datadir}/cgdb/ is not owned by any package

* Scriptlets
  Please add the needed Requires accroding to "Texinfo" section of
  http://fedoraproject.org/wiki/Packaging/ScriptletSnippets


Comment 6 Mamoru TASAKA 2007-01-09 17:33:49 UTC
One another comment (just from spec file)
* From rpmlint:
---------------------------------------------
W: cgdb macro-in-%changelog doc
---------------------------------------------
  Please don't use %doc in %changelog. Use %%doc.

Comment 7 Gilboa Davara 2007-01-09 18:07:04 UTC
1. BuildRequires:
In general, all 3 are installed by default - so they can be removed.
Hopefully it won't break non-mock builds.
Consider it done.

2. Requires: ncurses:
Ouch. Forgot that ncurses-devel requires ncurses.
Done.

3. Directories/files ownership issue.
4. Invalid %doc in changelog.
Done.

Spec URL: http://gilboadavara.thecodergeek.com/cgdb.spec
SRPM URL: http://gilboadavara.thecodergeek.com/cgdb-0.6.3-4.src.rpm

- Gilboa

Comment 8 Mamoru TASAKA 2007-01-10 19:40:20 UTC
I have not checked yet 0.6.3-4, however at least almost good.

So:
-------------------------------------------------------------
NOTE: Before being sponsored:

This package will be accepted with another few work. 
But before I accept this package, someone (I am a candidate) 
must sponsor you.

Once you are sponsored, you have the right to formally review other 
submitters' review request and approve the packages. 
For this reason, the person who want to be sponsored (like you) 
are required to "show that you have an understanding 
of the process and of the packaging guidelines" as is descriped
on :
http://fedoraproject.org/wiki/Extras/HowToGetSponsored


Usually there are two ways to show this.
A. submit other review requests with enough quality.
B. Do a "pre-review" (at the time you are not sponsored, you cannot do
   a formal review) of other person's review request.

When you submitted a new review request or have pre-reviewed other person's
review request, please write the bug number on this bug report so that I
can check your comments or review request.

Fedora Extras package review requests which are waiting for someone to review
can be checked on:
https://bugzilla.redhat.com/bugzilla/showdependencytree.cgi?id=FE-NEW&hide_resolved=1

Review guidelines are described mainly on:
http://fedoraproject.org/wiki/Packaging/ReviewGuidelines
http://fedoraproject.org/wiki/Packaging/Guidelines
http://fedoraproject.org/wiki/Packaging/ScriptletSnippets
------------------------------------------------------------

Comment 9 Mamoru TASAKA 2007-01-11 16:54:10 UTC
Well,

* Documentation
  - Consider to add doc/htdocs

* File entry
  - From mockbuild log:
----------------------------------------------
warning: File listed twice: /usr/share/cgdb/cgdb.txt
----------------------------------------------

* Timestamp
  - This package includes a documentation
    ( /usr/share/cgdb/cgdb.txt ) and keeping timestamp
    on this file is preferable.
    Use:
----------------------------------------------
make install DESTDIR=$RPM_BUILD_ROOT INSTALL="%{__install} -c -p"
----------------------------------------------

* Some notes:
  - Please remove unnecessary comments like:
----------------------------------------------
#make %{?_smp_mflags}
#Let RPM strip the debug info.
#strip $RPM_BUILD_ROOT/%{_bindir}/cgdb
----------------------------------------------

* A question:
  - Why is the command prompt of cgdb is "tgdb"?

----------------------------------------------
Copyright (C) 2006 Free Software Foundation, Inc.
GDB is free software, covered by the GNU General Public License, and you are
welcome to change it and/or distribute copies of it under certain conditions.
Type "show copying" to see the conditions.
There is absolutely no warranty for GDB.  Type "show warranty" for details.
This GDB was configured as "i386-redhat-linux-gnu"...Using host libthread_db
library "/lib/libthread_db.so.1".

(tgdb) 
----------------------------------------------

  And check my comment 8.

Comment 10 Gilboa Davara 2007-01-11 19:23:31 UTC
#8:
I've got a couple of other packages that are waiting in the pipe-line - I'll add
them ASAP. (and post the BZ# here.)
More-ever, I'll start following the review requests and see if I can help.

#9:
I'll fix the errors and upload nice spec file.

Thanks,
Gilboa


Comment 11 Gilboa Davara 2007-01-12 15:07:11 UTC
tgdb is cgdb's trivial GDB interface library which is being used to communicate
with the gdb back-end.
I have no idea why the up-stream maintainer doesn't change the prompt to cgdb.

Single question:
I'm pushing the htdocs under /usr/share/cgdb. Should I push it under
/usr/share/docs/cgdb instead?
As far as I could see, some html files go into /usr/share/<app> while others
go into /usr/doc/<app>


Spec URL: http://gilboadavara.thecodergeek.com/cgdb.spec
SRPM URL: http://gilboadavara.thecodergeek.com/cgdb-0.6.3-5.src.rpm

* Tue Jan 08 2007 <gilboad AT gmail DOT com> - 0.6.3-5
- Keep timestamps on install
- Remove unnecessary comments.
- Add missing HTML docs.

- Gilboa


Comment 12 Mamoru TASAKA 2007-01-12 15:15:46 UTC
(In reply to comment #11)
> I'm pushing the htdocs under /usr/share/cgdb. Should I push it under
> /usr/share/docs/cgdb instead?

Ah, no. Just add %doc doc/htdocs .

Comment 14 Gilboa Davara 2007-01-13 06:04:43 UTC
Sigh. Don't know how did I miss it... 

* Sat Jan 13 2007 <gilboad AT gmail DOT com> - 0.6.3-7
- Fix wrong license. (Was LGPL, should be GPL.)

Spec URL: http://gilboadavara.thecodergeek.com/cgdb.spec
SRPM URL: http://gilboadavara.thecodergeek.com/cgdb-0.6.3-7.src.rpm



Comment 15 Mamoru TASAKA 2007-01-13 07:43:24 UTC
Well,
* "INSTALL" document is not needed. This is needed for people
  who want to rebuild this by themselves and not needed for
  pre-built binary rpm.
* htdocs/cgdb.png is broken.
  So please remove this file for now and report to upstream

Other things are all okay.
-------------------------------------------------------------
      This package (cgdb) is APPROVED by me.
-------------------------------------------------------------
Please step forward according to
http://fedoraproject.org/wiki/Extras/Contributors .

When you follow some procedure, I should receive a mail
that you need a sponsor. Then I will sponsor you.

Comment 16 Gilboa Davara 2007-01-15 12:49:34 UTC
* Mon Jan 15 2007 <gilboad AT gmail DOT com> - 0.6.3-8
- Remove INSTALL
- Move cgdb.txt to %%docs. (Where index.html can see it.)
- Move htdocs to %%docs.
- Fix broken cgdb.png file.

Spec URL: http://gilboadavara.thecodergeek.com/cgdb.spec
SRPM URL: http://gilboadavara.thecodergeek.com/cgdb-0.6.3-8.src.rpm

I'll follow the instructions in "Contributors" ASAP.
FYI, another package up for review:
https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=222523


Comment 17 Mamoru TASAKA 2007-01-15 16:29:20 UTC
Well, for -8,

* Please keep the name of "htdocs", i.e. the entry of %doc
  should be "htdocs", not "htmldocs".
* Use "cp -p" to keep timestamps.
* For Source1:
  If this file is available from some URL, please specify the URL
  like Source0. If this file is something you created by ImageMagick,
  for example, please note how you created the file briefly as
  comments in spec file.
* For cgdb.txt:
  Well, I confirmed that this file is needed by 
  ./doc/htdocs/documentation.shtml, so actually
---------------------------
cp -p doc/cgdb.txt htdocs (please copy to this directory)
---------------------------
  is needed. And as you can see in ./cgdb/src/interface.c:
---------------------------
  1525  void
  1526  if_display_help (void)
  1527  {
  1528    char cgdb_help_file[MAXLINE];
  1529    int ret_val = 0;
  1530  
  1531    fs_util_get_path (PKGDATADIR, "cgdb.txt", cgdb_help_file);
  1532    ret_val = source_set_exec_line (src_win, cgdb_help_file, 1);
  1533    if (ret_val == 0)
  1534      if_draw ();
  1535    else if (ret_val == 5)        /* File does not exist */
  1536      if_display_message ("No such file: %s", 0, cgdb_help_file);
  1537  }
  1538  
---------------------------
  This file is also needed by cgdb binary, so please don't
  remove this from %{_datadir}/cgdb.

  After you fix these, you can import this to Fedora Extras.

Comment 18 Gilboa Davara 2007-01-15 16:56:58 UTC
Done.

* Mon Jan 15 2007 <gilboad AT gmail DOT com> - 0.6.3-9
- Do -not- delete cgdb.txt - needed by binary.
- Use the original htdocs instead of htmldocs.
- Preserve timestamps.
- Fix missing URL in imported cgdb.png.

Spec URL: http://gilboadavara.thecodergeek.com/cgdb.spec
SRPM URL: http://gilboadavara.thecodergeek.com/cgdb-0.6.3-9.src.rpm

I'll upload the files later today.

Thanks for the help,
- Gilboa

Comment 19 Mamoru TASAKA 2007-01-15 17:27:04 UTC
Okay, -9 is good.

Removing NEEDSPONSOR.

Comment 20 Mamoru TASAKA 2007-01-17 14:02:52 UTC
(Just changing to NEXTRELEASE)

Comment 21 Gilboa Davara 2007-01-17 14:29:16 UTC
Thanks.

(Though, technically, my FC6 branch request has yet to be processed, so for now,
this is strictly -devel release...)

- Gilboa


Comment 22 Mamoru TASAKA 2007-01-17 15:23:52 UTC
Hello.

As David Nielsen pointed out, please check:
https://bugzilla.redhat.com/bugzilla/showdependencytree.cgi?id=FE-NEW&hide_resolved=1
There are ..actually... many requests which are in need of reviewers.

Well, everyone including me was a newbie at first. Please
try reviewing (though some package needs some knowledge other
than only packaging issue....). If you have some questions, I _must_
help you as sponsor.

Comment 23 Gilboa Davara 2007-01-17 16:08:43 UTC
I'll contact you if I have any questions.
I'll try not to bug you too much ;)

Thanks,
- Gilboa