[Bug 250393] New: README.kde-qt misleading and incomplete

[Christopher Yeleighton]

https://bugs.kde.org/show_bug.cgi?id=250393

           Summary: README.kde-qt misleading and incomplete
           Product: kde
           Version: CVS
          Platform: Compiled Sources
        OS/Version: Linux
            Status: UNCONFIRMED
          Severity: normal
          Priority: NOR
         Component: general
        AssignedTo: unassigned-bugs at kde.org
        ReportedBy: giecrilj at stegny.2a.pl


Version:           CVS (using Devel) 
OS:                Linux

The instructions in README.kde-qt are misleading and insufficient for
troubleshooting.

Reproducible: Sometimes

Steps to Reproduce:
1. Run make in qt-copy.
2. Run kdesrc-build.
3. Examine kdesvn/log/latest/qt-copy/configure.log
4. Turn to README.kde-qt for instructions.  
5. rm .qmake.cache
6. Run kdesrc-build.
7. Examine kdesvn/log/latest/qt-copy/configure.log
8. Modify README.kde-qt with the expected result of step 4.
9. Follow the instructions to push the patch, including "git push".
10. Get a Gitorious account and upload the SSH key.
11. Repeat "git push".

Actual Results:  
2. 
You cannot make a shadow build from a source tree containing a previous build.
Cannot proceed.

4.
    rm .qmake.cache

7.
You cannot make a shadow build from a source tree containing a previous build.
Cannot proceed.

9.
Permission denied (publickey).      
fatal: The remote end hung up unexpectedly                     

11. 
== Gitorious: ===========================================================
You do not have write access to this repository                          
======================================================================== 

Expected Results:  
4. 
    rm .qmake.cache src/corelib/global/qconfig.h src/corelib/global/qconfig.cpp

9. 
The instructions should include getting a Gitorious account and uploading the
SSH key.

11. 
The preamble to README.kde-qt should state explicitly that the text applies
ONLY to authorised developers of KDE.



*** README.kde-qt       2010-09-06 21:00:23.303102981 +0200                
--- README.kde-qt-      2010-09-06 20:48:16.186106779 +0200                
*************** installation.                                              
*** 126,132 ****                                                           
  ====================================                                     

  If you have fixed a bug in Qt or modified it in any way that may         
! benefit others, please share your change in the form of a patch. Do      
  not commit your changes directly to the main branch because they         
  may be lost in a future update if they have not been added to the        
  official Qt release.                                                     
--- 126,134 ----                                                           
  ====================================                                     

  If you have fixed a bug in Qt or modified it in any way that may         
! benefit others and you are a registered KDE developer,                   
! please share your change in the form of a patch.                         
! Otherwise, file a bug at bugs.kde.org. Do                                
  not commit your changes directly to the main branch because they
  may be lost in a future update if they have not been added to the
  official Qt release.
*************** To create a patch, do the following:
*** 182,187 ****
--- 184,191 ----

    g) push the changes you made to your branch and to the main server:
        git push git at gitorious.org:qt/kde-qt.git master 4.5.1-patched
patches/0180-window-role
+   (You need an active Gitorious account with write access
+    and a valid SSH key for that.)
    (Don't forget to list all 3 branch names)

  Don't forget to submit your patch to using the Qt Contribution Model,
*************** top directory of your Qt sources:
*** 200,206 ****
        find . -name '*.moc' | xargs rm

  Sometimes ./configure will refuse to run.  You may need to:
!       rm .qmake.cache

  If you think you may have run "make install" on an install-less Qt
  (srcdir == $QTDIR), run:
--- 204,210 ----
        find . -name '*.moc' | xargs rm

  Sometimes ./configure will refuse to run.  You may need to:
!       rm .qmake.cache src/corelib/global/qconfig.h
src/corelib/global/qconfig.cpp

  If you think you may have run "make install" on an install-less Qt
  (srcdir == $QTDIR), run:

-- 
Configure bugmail: https://bugs.kde.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.