[documentation] [Documentation task] Move http://drupal.org/node/23409 to appropriate parent

Thu Jul 27 07:21:02 UTC 2006

Issue status update for 
http://drupal.org/node/75788
Post a follow up: 
http://drupal.org/project/comments/add/75788

 Project:      Documentation
 Version:      <none>
 Component:    User Guide
 Category:     tasks
 Priority:     normal
 Assigned to:  Anonymous
 Reported by:  Ramdak
 Updated by:   Heine
 Status:       active

http://drupal.org/node/324 contains a number of Visual diff programs.
While useful to compare revisions, they do not all let one save
patches. I will only keep the programs that can create patches. What
remains, seems more a general CVS / TortoiseCVS & create patches, so
I'll put a revision under Create patches on Windows [1] in the format
of the Subversion and TortoiseSVN entries.
[1] http://drupal.org//node/60234

Heine

Previous comments:
------------------------------------------------------------------------

Thu, 27 Jul 2006 06:19:04 +0000 : Ramdak

http://drupal.org/node/23409 about *applying* patches on Windows is
under the how-to for *creating patches*.

I think a more appropriate location would be as a child page of
http://drupal.org/node/60179

------------------------------------------------------------------------

Thu, 27 Jul 2006 06:32:53 +0000 : Heine

The pages

- Diff on Windows http://drupal.org/node/324
- Patch on Windows  http://drupal.org/node/23409

have to be incorporated under either Apply / Create patches in the
correct format (one page per program), not just moved. Some pages can
be deleted.

I feel it's best done by people who have actually used /tested the
howto with the program.

------------------------------------------------------------------------

Thu, 27 Jul 2006 06:43:59 +0000 : Ramdak

You are right. I just submitted an issue about restructuring the
handbook to separate *apply* from *create* and also have separate pages
for each program.

I have installed and used Cygwin successfully to patch files, so I
think I can handle that. Even otherwise, I feel I can redo the pages in
a proper structure and someone more experienced can vet them before they
are committed to the handbook.

------------------------------------------------------------------------

Thu, 27 Jul 2006 06:45:54 +0000 : sepeck

actually, redo the pages, then we'll vet them.  If we can;t make them
work then we'll just remove them.

------------------------------------------------------------------------

Thu, 27 Jul 2006 06:47:38 +0000 : Heine

The apply patch part is done.

------------------------------------------------------------------------

Thu, 27 Jul 2006 06:48:00 +0000 : Ramdak

Thanks, Sepeck, I will.

------------------------------------------------------------------------

Thu, 27 Jul 2006 06:49:23 +0000 : Heine

Ramdak, can you compare the following with http://drupal.org/node/32875
and indicate what should be added to 32875?

* Get the latest version of Cygwin at Cygwin.com [2]. What you download
is actually a small setup file that will reconnect to the web for more
data when executed.
* Run setup.exe. Chose "install from the internet", an appropriate
directory, connection type etc. matching your system. In the next
window, chose a server near to you (btw: no problem to cancel & restart
with a different server, if the first choice is slow).
* In the next window you get a list of available packages - now it's
important to add "patch" to the list, since it is not included by
default. You have to find it by pressing the "view"-Button once to see
all of the packages (view cycles between "category", "all" and
"updated"). Scroll down until you see "patch" in the column "Packages".
Klick the small Icon with the text "skip" way to the left in the line -
"skip" will change to a version number. This means the package will be
installed. (at this point you could also deactivate a whole bunch of
the other packages, if you don't need them. If you don't, the
setup-process takes a while.)
* Run cygwin. In the explorer, you will see that a unix-like
directory-structure has been created inside the installation directory.
when you run the program for the first time, a user-directory is created
below the "home"-directory. This will be your default directory when
working with cygwin -  the easiest way is to put the original file &
the patch there (so you don't have to enter a lengthy path to your
commands).
* Patch! :) In the open shell (command window) just enter the command:
patch -p0 original.filename nameofyour.patch
* If you get errors while patching, try to use the original file fresh
from the drupal server. I used a module from my working server, and the
patch command threw all kinds of errors. Seems as if the line-numbers
have been messed up somehow by copying & viewing. Although I do not
understand how this could happen.
* Before you copy the patched file to your server, rename the old
one... you never know if it really works in your environment.

[2] http://www.cygwin.com/

------------------------------------------------------------------------

Thu, 27 Jul 2006 06:52:27 +0000 : Ramdak

Heine, thanks, I will. 

I think the apply patch page for cygwin you just moved
(http://drupal.org/node/32875) has gone into the *create* patches
section.

------------------------------------------------------------------------

Thu, 27 Jul 2006 06:59:27 +0000 : Heine

Thanks, fixed that.

------------------------------------------------------------------------

Thu, 27 Jul 2006 07:03:27 +0000 : Ramdak

Comparing the two pages, I feel http://drupal.org/node/32875 has the
kind of detailed instructions and handholding that will make the
process of installing easy for newbies. I remember that I was only able
to install Cygwin properly because of that page, not the other one. The
current revision might be just a bit heavy for newbies. Just a thought.

------------------------------------------------------------------------

Thu, 27 Jul 2006 07:13:29 +0000 : Heine

I had removed the text above in favor of http://drupal.org/node/32875,
so that is the default page. As, if you say the text above doesn't add
to the docs, I will delete it from the moderation queue.