|
|
| (90 intermediate revisions by 2 users not shown) |
| Line 1: |
Line 1: |
| − | {{Note|text=Feel free to correct, add, expand, anything that could make this better and clearer. ^_^}}
| + | #REDIRECT [[Newbie_Guide:_Getting_Started_on_Windows]] |
| − | | + | |
| − | {{Note|text=For Mac users, see [http://sarken.dreamwidth.org/1747903.html Patching Styles and Other Things on a Mac] by <dwuser>sarken</dwuser>.}}
| + | |
| − | | + | |
| − | | + | |
| − | = Install and Set Things Up =
| + | |
| − | | + | |
| − | This may seem like a lot of things to do before you can really get started, things you may not be familiar with but 1) you can do it 2) you only have to do this once.
| + | |
| − | | + | |
| − | | + | |
| − | == Get a Dreamhack ==
| + | |
| − | | + | |
| − | What's a Dreamhack? To put it simply, it's an online mirror of the Dreamwidth site which is set up for any developer, beginner or experienced, who asks for it. This way, you don't have to go through the complicated process of installing Dreamwidth on your own computer.
| + | |
| − | | + | |
| − | * Apply for a Dreamhack by [http://hack.dreamwidth.net/apply.shtml filling this form]. The two important fields are 'Your Desired Username' and 'Your email address'. Your username is used to manage your Dreamhack and to create the URL where your Dreamhack will be located at so you can pick anything. Your email address is used to send you a welcome e-mail which contains important information as well as various alerts. You can pick any of your existing email addresses or choose to create an email account entirely devoted to your development work.
| + | |
| − | | + | |
| − | * Once you're done, you should get an e-mail with your login username and a password. Don't lose it. Once you've gotten this e-mail, you need to install two programs to be able to manage your Dreamhack: [[PuTTY]] and [http://winscp.net/eng/download.php WinSCP].
| + | |
| − | | + | |
| − | == Install PuTTY ==
| + | |
| − | | + | |
| − | What for? [[PuTTY]] will allow you to start and stop your Dreamhack, update it when changes are made either by you or other developers, and generate patches.
| + | |
| − | | + | |
| − | * Download 'Windows installer for everything except PuTTYtel' .exe file at [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html PuTTY] and install it.
| + | |
| − | | + | |
| − | * Run PuTTY. In the configuration window, enter "hack.dreamwidth.net" for the host name. Go to Connection/Data and enter the username/login given to you in the welcome e-mail. It should be something like dh-username.
| + | |
| − | | + | |
| − | * Click on Open. If you get a pop-up message about a key, click Yes.
| + | |
| − | | + | |
| − | * Enter the password given to you in the welcome e-mail when asked. Note that no characters are displayed and the cursor won't move. It's normal.
| + | |
| − | | + | |
| − | * Change your password by typing:
| + | |
| − | <syntaxhighlight lang="bash">passwd</syntaxhighlight>
| + | |
| − | | + | |
| − | * And that's it for now. :)
| + | |
| − | | + | |
| − | == Install WinSCP ==
| + | |
| − | | + | |
| − | What for? WinSCP will allow you to browse and edit your Dreamhack files.
| + | |
| − | | + | |
| − | * Install [http://winscp.net/eng/download.php WinSCP]. During the installation, you may be asked about the mode you prefer: Commander and Explorer. Commander works like an FTP client: a partitioned window with your computer files on one side and the Dreamhack files on the other. Explorer will only display your Dreamhack files and works like Windows's Explorer. I prefer this mode because I rarely need to access my computer files but choose what's easiest for you.
| + | |
| − | | + | |
| − | * Use "hack.dreamwidth.net" for the host name. Enter your username and your new password. Click on Save then on Login.
| + | |
| − | | + | |
| − | == Set Up Your Dreamhack ==
| + | |
| − | | + | |
| − | This part can seem daunting but is mainly a lot of copy/pasting. Take your time and you'll be fine.
| + | |
| − | | + | |
| − | === Protect Your Config Files ===
| + | |
| − | | + | |
| − | (From [[Dreamhack_getting_started#Back_up_your_configs|Back Up Your Configs]] and [[Dreamhack_getting_started#Protect_your_configs_from_updates|Protect your configs from updates]])
| + | |
| − | | + | |
| − | * In PuTTY, copy/paste the following lines to create the ~/config-backup directory and copy your config files into it:
| + | |
| − | | + | |
| − | <source lang="bash">mkdir ~/config-backup
| + | |
| − | cp $LJHOME/etc/config* ~/config-backup</source>
| + | |
| − | | + | |
| − | * Then copy/paste the following code to create editable copies of your config files:
| + | |
| − | | + | |
| − | <source lang="bash">cd $LJHOME
| + | |
| − | mkdir cvs/local cvs/local/etc cvs/local/cvs
| + | |
| − | cp etc/config-local.pl cvs/local/etc
| + | |
| − | cp etc/config.pl cvs/local/etc
| + | |
| − | cp etc/config-private.pl cvs/local/etc</source>
| + | |
| − | | + | |
| − | * In WinSCP, go to <code>/dw/cvs/local/cvs/</code>.
| + | |
| − | * In the right-sided window, right-click and select New/File. Call it <code>multicvs-private.conf</code>. Copy/paste this and save:
| + | |
| − | | + | |
| − | local .
| + | |
| − | | + | |
| − | * Go back to PuTTY and copy/paste this:
| + | |
| − | | + | |
| − | <source lang="bash">cp $LJHOME/cvs/local/cvs/multicvs-private.conf $LJHOME/cvs/
| + | |
| − | cp etc/config-private.pl cvs/local/etc</source>
| + | |
| − | | + | |
| − | Note: you've used three 'bash' commands in PuTTY: <code>cd A</code> to go to the A directory; <code>mkdir B</code> to create the B directory; <code>cp C D</code> to copy C to D.
| + | |
| − | | + | |
| − | | + | |
| − | === Create Scripts for Routine Tasks ===
| + | |
| − | | + | |
| − | (From [[Dev_Maintenance#Scripting|Scripting]])
| + | |
| − | | + | |
| − | * In WinSCP, go to <code>/bin</code> and create three files called dwu, dws, dwdb (u for Update; s for Synchronize; db for DataBase).
| + | |
| − | | + | |
| − | * In each of this file, copy/paste this:
| + | |
| − | | + | |
| − | dwu:
| + | |
| − | | + | |
| − | <source lang="bash">#!/bin/bash
| + | |
| − | hg -R $LJHOME/cvs/dw-free qpop -a && \
| + | |
| − | hg -R $LJHOME/cvs/dw-nonfree qpop -a && \
| + | |
| − | $LJHOME/bin/cvsreport.pl -u && \
| + | |
| − | hg -R $LJHOME/cvs/dw-free qpush -a && \
| + | |
| − | hg -R $LJHOME/cvs/dw-nonfree qpush -a</source>
| + | |
| − | | + | |
| − | dws:
| + | |
| − | | + | |
| − | <source lang="bash">#!/bin/bash
| + | |
| − | $LJHOME/bin/cvsreport.pl -s -c && \
| + | |
| − | $LJHOME/bin/cvsreport.pl -s -c
| + | |
| − | cd $LJHOME; for i in $(bin/cvsreport.pl -n -1); do echo "Removing $i" && rm $i; done</source>
| + | |
| − | | + | |
| − | dwdb:
| + | |
| − | | + | |
| − | <source lang="bash">#!/bin/bash
| + | |
| − | $LJHOME/bin/upgrading/update-db.pl -r -p --innodb && \
| + | |
| − | $LJHOME/bin/upgrading/update-db.pl -r --cluster=all --innodb && \
| + | |
| − | $LJHOME/bin/upgrading/texttool.pl load</source>
| + | |
| − | | + | |
| − | * In PuTTY, copy/paste this to make the scripts executable:
| + | |
| − | | + | |
| − | <source lang="bash">
| + | |
| − | chmod ugo+x ~/bin/dwu
| + | |
| − | chmod ugo+x ~/bin/dws
| + | |
| − | chmod ugo+x ~/bin/dwdb</source>
| + | |
| − | | + | |
| − | * For more scripts, see [http://dw-dev-training.dreamwidth.org/26408.html this entry].
| + | |
| − | | + | |
| − | * Tip: a useful script you can create is one which stops your hack, synchronize it, update the database and restart your hack.
| + | |
| − | | + | |
| − | === Manage Your System Account ===
| + | |
| − | | + | |
| − | * Your default Dreamhack account is called system. Go to PuTTY and type this to set its password:
| + | |
| − | | + | |
| − | <source lang="bash">$LJHOME/bin/upgrading/make_system.pl</source>
| + | |
| − | | + | |
| − | * Log in to your Dreamhack (http://www.yourusername.hack.dreamwidth.net/) using system and your new password.
| + | |
| − | | + | |
| − | * Go to [http://www.yourusername.hack.dreamwidth.net/admin/priv/ http://www.yourusername.hack.dreamwidth.net/admin/priv/]. Click on 'payments' type 'system' in the User field then click on 'Make Changes'. The system account now has the ability (called 'privilege' or 'priv') to give paid time to any account.
| + | |
| − | | + | |
| − | * Go to [http://www.yourusername.hack.dreamwidth.net/admin/pay http://www.yourusername.hack.dreamwidth.net/admin/pay]. Type 'system' in the Edit user field and click on Go. Make your account a seed one.
| + | |
| − | | + | |
| − | | + | |
| − | === Get Rid of Invite Codes ===
| + | |
| − | | + | |
| − | * In WinSCP, go to <code>/dw/cvs/local/etc/</code>, and double-click on <code>config.pl</code>. Find <code>$USE_ACCT_CODES = 1;</code> and change 1 to <code>0</code>. Save your file.
| + | |
| − | | + | |
| − | * In PuTTY, type this to make the changes go live on your Dreamhack:
| + | |
| − | | + | |
| − | <source lang="bash">cd $LJHOME
| + | |
| − | stop-apache
| + | |
| − | dws
| + | |
| − | dwdb
| + | |
| − | start-apache</source>
| + | |
| − | | + | |
| − | == Create a Bugzilla account ==
| + | |
| − | | + | |
| − | * Simply [http://bugs.dwscoalition.org/createaccount.cgi click here].
| + | |
| − | | + | |
| − | * As <dwuser>mark</dwuser> explained [http://dw-dev.dreamwidth.org/17146.html here], go to [http://bugs.dwscoalition.org/userprefs.cgi?tab=account Name and Password] and enter your name following this format: <code>Name [:username]</code>. 'Name' can be your real name, a nickname, your username again, etc. You don't have to give your real name if you don't want to.
| + | |
| − | | + | |
| − | | + | |
| − | == Finish Setting Up Your Dreamhack ==
| + | |
| − | | + | |
| − | * The final and last step is to create files and folders for patches.
| + | |
| − | | + | |
| − | * In PuTTY, type this to create files and folders in <code>~/dw/cvs/dw-free/.hg/</code>:
| + | |
| − | | + | |
| − | <source lang="bash">cd $LJHOME/cvs/dw-free
| + | |
| − | hg qinit -c</source>
| + | |
| − | | + | |
| − | * In WinSCP, open <code>~/dw/cvs/dw-free/.hg/hgrc</code> and add this:
| + | |
| − | | + | |
| − | <source lang="ini">[ui]
| + | |
| − | username = username <username@gmail.com></source>
| + | |
| − | | + | |
| − | * Change the second username to your Bugzilla name and the e-mail address to your Bugzilla address. Save the file.
| + | |
| − | | + | |
| − | * In PuTTY again, type this to create files and folders in <code>~/dw/cvs/dw-nonfree/.hg/</code>:
| + | |
| − | | + | |
| − | <source lang="bash">cd $LJHOME/cvs/dw-nonfree
| + | |
| − | hg qinit -c</source>
| + | |
| − | | + | |
| − | * In WinSCP, open <code>~/dw/cvs/dw-nonfree/.hg/hgrc</code> and add this:
| + | |
| − | | + | |
| − | <source lang="perl">[ui]
| + | |
| − | username = username <username@gmail.com></source>
| + | |
| − | | + | |
| − | * Change the second username to your Bugzilla name and the e-mail address to your Bugzilla address. Save the file.
| + | |
| − | | + | |
| − | = How All of This Works =
| + | |
| − | | + | |
| − | == PuTTY, WinSCP or Bugzilla ? ==
| + | |
| − | | + | |
| − | * You use PuTTY to update your Dreamhack code, make your changes go live on your Dreamhack, create patches and manage patches.
| + | |
| − | | + | |
| − | * You use WinSCP to edit Dreamhack files.
| + | |
| − | | + | |
| − | * You use Bugzilla to find bugs, file bugs, and upload patches.
| + | |
| − | | + | |
| − | | + | |
| − | == Folders and Files You Work With ==
| + | |
| − | | + | |
| − | * Your Dreamhack has two parts:
| + | |
| − | ** the live part (<code>~/dw/*</code>)
| + | |
| − | ** the repository part (<code>~/dw/cvs/dw-free/*</code> and <code>~/dw/cvs/dw-nonfree/*</code>).
| + | |
| − | | + | |
| − | * What you see on [http://www.yourusername.hack.dreamwidth.net/ http://www.yourusername.hack.dreamwidth.net/] is the live part.
| + | |
| − | | + | |
| − | * But you work with in the repositories: you edit repository files and you create patches in repository folders.
| + | |
| − | | + | |
| − | | + | |
| − | == Updating Your Repository Code ==
| + | |
| − | | + | |
| − | * Code is committed by developers all the time. You must regularly update your repositories by running the 'Update' script:
| + | |
| − | <syntaxhighlight lang="bash">cd $LJHOME
| + | |
| − | stop-apache
| + | |
| − | dwu
| + | |
| − | start-apache</syntaxhighlight>
| + | |
| − | | + | |
| − | * Note that this won't update your Dreamhack. You need to make the changes go live with the next step:
| + | |
| − | | + | |
| − | | + | |
| − | == Making Changes Go Live on Your Dreamhack ==
| + | |
| − | | + | |
| − | * To do that, you use the 'Synchronize' and 'DataBase' scripts:
| + | |
| − | <syntaxhighlight lang="bash">cd $LJHOME
| + | |
| − | stop-apache
| + | |
| − | dws
| + | |
| − | dwdb
| + | |
| − | start-apache</syntaxhighlight>
| + | |
| − | | + | |
| − | | + | |
| − | = Before You Edit Anything =
| + | |
| − | | + | |
| − | == Find or File a Bug ==
| + | |
| − | | + | |
| − | * To find: you can use [http://bugs.dwscoalition.org/userprefs.cgi?tab=saved-searches predefined searches] such as [http://bugs.dwscoalition.org/buglist.cgi?cmdtype=dorem&remaction=run&namedcmd=unassigned%20effort-minor&sharer_id=2 unassigned effort-minor].
| + | |
| − | | + | |
| − | : Some of these bugs won't appear to require 'minor' effort to you. It's normal. Try to find small bugs among them: minor modifications to be done on one of the site pages (text to be modified; elements to be added, removed or moved; elements to be hidden from some categories of users, etc.).
| + | |
| − | | + | |
| − | * To file: make sure it's not already been filed using [http://bugs.dwscoalition.org/query.cgi?format=specific simple search] or [http://bugs.dwscoalition.org/query.cgi?format=advanced advanced search] then [http://bugs.dwscoalition.org/enter_bug.cgi?product=Dreamwidth%20Development use this form] to file a new bug. Fill and edit the fields as needed.
| + | |
| − | | + | |
| − | * To assign a bug to yourself, enter your Bugzilla e-mail address in Assign To and set the status to IN_PROGRESS.
| + | |
| − | | + | |
| − | : To make this easier, you can also use of <dwuser>fu</dwuser>'s Greasemonkey scripts: [http://www.afunamatata.com/greasemonkey/ Dreamwidth Bug Grabber]. Click on (grab!) next to Assign To and this will edit it and Status for you. Click on Save Changes of course.
| + | |
| − | | + | |
| − | == Create a Patch ==
| + | |
| − | | + | |
| − | * Open PuTTY and update everything by running the three scripts. You need to work with the latest code.
| + | |
| − | | + | |
| − | * Go to dw-free by typing this:
| + | |
| − | | + | |
| − | <source lang="bash">cd $LJHOME
| + | |
| − | tocvs f</source>
| + | |
| − | | + | |
| − | * If you need to go to dw-nonfree, type this instead:
| + | |
| − | | + | |
| − | <source lang="bash">cd $LJHOME
| + | |
| − | tocvs n</source>
| + | |
| − | | + | |
| − | * Create a new patch by typing this (change NUMBER and PATCHNAME of course):
| + | |
| − | | + | |
| − | <source lang="bash">hg qnew bugNUMBER_PATCHNAME.diff</source>
| + | |
| − | | + | |
| − | = Edit Files =
| + | |
| − | | + | |
| − | * Use WinSCP to open the file(s) you need to edit. WinSCP will open the files with your default editor, probably Windows's Notepad. While you can use Notepad to edit files, it may not be the best editor you could use. I recommend [[Editor:_Notepad_plus_plus | Notepad++]] instead.
| + | |
| − | | + | |
| − | * If you're working on site pages, you're working on .bml files. These are in <code>~dw/cvs/dw-free/htdocs/</code> or one of the subsequent folders. You'll see that their names correspond to the URLs of site pages. These files may use .pm modules/widgets which are in <code>~dw/cvs/dw-free/cgi-bin/DW/</code> or <code>~dw/cvs/dw-free/cgi-bin/LJ/</code>.
| + | |
| − | | + | |
| − | * For text strings which are not in <code>~dw/cvs/dw-free/htdocs/xxx.bml.text</code> files, see <code>~dw/cvs/dw-free/bin/upgrading/en.dat</code>.
| + | |
| − | | + | |
| − | * For more specific searches, you can use the grep command: <code>grep [option(s)] pattern [file(s)]</code>
| + | |
| − | | + | |
| − | Interesting options:
| + | |
| − | | + | |
| − | -E: match using extended regular expressions
| + | |
| − | -F: match using fixed strings
| + | |
| − | -r: recursive
| + | |
| − | -i: case insensitive
| + | |
| − | -l: filename only
| + | |
| − | -n: add relative line number
| + | |
| − | | + | |
| − | Examples:
| + | |
| − | | + | |
| − | <syntaxhighlight lang="bash">grep -ri "find this text" * | more</syntaxhighlight>
| + | |
| − | | + | |
| − | : This will search for "find this text" in all files.
| + | |
| − | | + | |
| − | <syntaxhighlight lang="bash">grep -rl print_entry $LJHOME/bin/upgrading/s2layers</syntaxhighlight>
| + | |
| − | | + | |
| − | : This will search for files containing "print_entry" in the /s2layers folder.
| + | |
| − | | + | |
| − | = Test Your Changes on Your Dreamhack =
| + | |
| − | | + | |
| − | * In PuTTY, stop your Dreamhack:
| + | |
| − | <syntaxhighlight lang="bash">cd $LJHOME
| + | |
| − | stop-apache</syntaxhighlight>
| + | |
| − | | + | |
| − | * Synchronize your live code and update your database:
| + | |
| − | <syntaxhighlight lang="bash">dws
| + | |
| − | dwdb</syntaxhighlight>
| + | |
| − | | + | |
| − | * Start your Dreamhack again:
| + | |
| − | <syntaxhighlight lang="bash">start-apache</syntaxhighlight>
| + | |
| − | | + | |
| − | * Go to your Dreamhack and test. Edit the files again in WinSCP if more changes are needed. Go through these steps again to test your new changes.
| + | |
| − | | + | |
| − | | + | |
| − | = Submit Your Patch =
| + | |
| − | | + | |
| − | == Update & Save Your Patch ==
| + | |
| − | | + | |
| − | * In PuTTY, go to dw-free or dw-nonfree (<code>tocvs f</code> or <code>tocvs n</code>)
| + | |
| − | | + | |
| − | * Type this to update your patch file:
| + | |
| − | <syntaxhighlight lang="bash">hg qrefresh</syntaxhighlight>
| + | |
| − | | + | |
| − | * Go to your patch directory in WinSCP (e.g. <code>/dw/cvs/dw-free/.hg/patches</code>) and save a copy of your patch on your computer.
| + | |
| − | | + | |
| − | {{Warn|text=Do not manually edit your patch. This may cause errors that make your patch invalid. Edit your file again. Refresh your patch. Test again.}}
| + | |
| − | | + | |
| − | == Upload Your Patch to Bugzilla ==
| + | |
| − | | + | |
| − | * Log in to [http://bugs.dwscoalition.org/ Bugzilla] and open your bug.
| + | |
| − | | + | |
| − | * Click on 'Add an Attachment' to attach your patch. Add a description, check 'patch' and set Flags/Commit and Flags/Review to ?. Feel free to add a comment if you have questions or remarks. Click on Submit.
| + | |
| − | | + | |
| − | : To help you with this, you can use one of <dwuser>fu</dwuser>'s Greasemonkey scripts: [http://www.afunamatata.com/greasemonkey/ Dreamwidth Patch Upload Defaults]. This will automatically check 'patch' and set the flags for you.
| + | |
| − | | + | |
| − | * Wait for someone to review and commit your patch. You're done. :)
| + | |
| − | | + | |
| − | * (optional) [[Patches|Further reading on patches]]
| + | |
| − | | + | |
| − | = Getting Back to Default Code =
| + | |
| − | | + | |
| − | * Pop your patch out of the pile with:
| + | |
| − | <syntaxhighlight lang="bash">hg qpop</syntaxhighlight>
| + | |
| − | | + | |
| − | * Then delete it:
| + | |
| − | <syntaxhighlight lang="bash">hg qdel BUGNAME</syntaxhighlight>
| + | |
| − | | + | |
| − | : If you want to keep the patch file, use <code>hg qdel -k BUGNAME</code> instead.
| + | |
| − | | + | |
| − | : If you don't remember the name of your bug you can use <code>hg qseries -v</code>. This will list all the patches you have in your patch queue.
| + | |
| − | | + | |
| − | : You can also the use the bug number in the queue instead of its name: <code>hg qdel 0</code>
| + | |
| − | | + | |
| − | * And finally use <code>dws</code> and <code>dwdb</code> to remove changes from your Dreamhack.
| + | |
| − | | + | |
| − | | + | |
| − | = More: Navigating Your Patch Queue =
| + | |
| − | | + | |
| − | If you have a long list of patches and you want to make changes to a patch that is buried in your queue, you can use the <code>hg qgoto</code> command. Simply add the name or the number of your patch after it and it will pop patches until it reaches this patch. You can also use it to go back further up in the queue. It will then push patches until it reaches the one you want.
| + | |
| − | | + | |
| − | | + | |
| − | = More: Reordering Patches =
| + | |
| − | | + | |
| − | Sometimes, while making a patch, you realize something else needs to be fixed first and you go ahead and do that and forget all about the other patch till you realize you need to do further work on it and it's at the bottom of the stack. Of course, you can pop the other patch to be able to edit it but a simpler solution might be to reorder your patches providing they don't deal with the same code:
| + | |
| − | | + | |
| − | * Pop all your patches with <code>hg qpop -a</code>.
| + | |
| − | | + | |
| − | * Open <code>/.hg/patches/series</code> and reorder the lines.
| + | |
| − | | + | |
| − | * Push all your patches again with <code>hg qpush -a</code>.
| + | |
| − | | + | |
| − | | + | |
| − | = More: Merging Patches =
| + | |
| − | | + | |
| − | Sometimes it's a good idea to do things in stages by creating several patches which can be applied successively. It allows you to easily go back to a previous version if things go wrong at some point without losing all your work, or to experiment. However, once you're satisfied with your work, you may want to merge your series of patches to upload only one for review. You can do that using the <code>hg qfold</code> command:
| + | |
| − | | + | |
| − | * First unapply the patches you want to merge using <code>hg qpop</code>.
| + | |
| − | | + | |
| − | * Create a new patch using <code>hg qnew</code>.
| + | |
| − | | + | |
| − | * List the patches you want to merge after <code>hg qfold</code>. Be careful! You need to list them in the order you've created them so start with your oldest one.
| + | |
| − | <syntaxhighlight lang="bash">hg qfold PATCH1 PATCH2 PATCH3</syntaxhighlight>
| + | |
| − | | + | |
| − | : PATCH1 will be merged into NEW. PATCH2 will be merged into PATCH1. PATCH3 will be merged into PATCH2.
| + | |
| − | | + | |
| − | | + | |
| − | = More: Importing a Patch =
| + | |
| − | | + | |
| − | * Sometimes you want to unapply a patch, go back to default code and reapply it later; or you need to import someone else's patch because you want to add something to it or because it blocks your own bug as you're working on the same file.
| + | |
| − | | + | |
| − | * In PuTTY, create a new folder to store patches using the <code>mkdir</code> command:
| + | |
| − | <syntaxhighlight lang="bash">mkdir ~/patches</syntaxhighlight>
| + | |
| − | | + | |
| − | * If you want to save one of your own patches, simply copy/paste the patch into this folder with WinSCP.
| + | |
| − | | + | |
| − | * If you want to import a patch from Bugzilla use the <code>wget</code> command to download it:
| + | |
| − | <syntaxhighlight lang="bash">wget -O ~/patches/bugNUMBER_PATCHNAME.diff BUGZILLA_URL</syntaxhighlight>
| + | |
| − | | + | |
| − | : The Bugzilla URL is something like http://bugs.dwscoalition.org/attachment.cgi?id=NUMBER
| + | |
| − | | + | |
| − | * When you want to apply any of your stored patches, go to dw-free/dw-nonfree in PuTTY.
| + | |
| − | | + | |
| − | * Put the patch in your patch queue:
| + | |
| − | <syntaxhighlight lang="bash">hg qimport ~/patches/bugNUMBER_PATCHNAME.diff</syntaxhighlight>
| + | |
| − | | + | |
| − | * Apply the patch when you want to:
| + | |
| − | <syntaxhighlight lang="bash">hg qpush</syntaxhighlight>
| + | |
| − | | + | |
| − | = More: Troubleshooting Tips =
| + | |
| − | | + | |
| − | == Issues With Update and Synchronize ==
| + | |
| − | | + | |
| − | * If your repositories won't update properly with <code>dwu</code>, you may need to go to dw-free/dw-nonfree and remove all your local changes with <code>hg update -C</code> then run <code>dwu</code> again.
| + | |
| − | | + | |
| − | * If <code>dwu</code> gets interrupted and you get an error message about one of the folders, you can try removing the folder and running update again:
| + | |
| − | <syntaxhighlight lang="bash">
| + | |
| − | cd $LJHOME/cvs
| + | |
| − | rm -rf FOLDERNAME
| + | |
| − | $LJHOME/bin/cvsreport.pl -checkout</syntaxhighlight>
| + | |
| − | | + | |
| − | * If your live code won't sync with your repository code, it may be because the files you've edited got saved using your computer time and not distant time. As the system relies on timestamps to see which files need to be updated, updates won't happen if live files seem to be more recent than repository files. Quickest trick is to change your computer time, open and save your files again so they get a later timestamp, refresh your patch and sync again. Also, make sure to check the DST options in WinSCP (Environment section).
| + | |
| − | | + | |
| − | == Issues With Patches and the Patch Queue ==
| + | |
| − | | + | |
| − | * If you've forgotten to create your patch before you edited your files, don't panic. Try <code>hg qnew -f bugNUMBER_PATCHNAME.diff</code>. This will force patch creation.
| + | |
| − | | + | |
| − | * If you get an error message saying that 'working directory is not qtip' when trying to refresh, create, or do anything else related to patches, try <code>hg update -C tip</code>. You may have lost some of your changes but your patch queue should be working again.
| + | |
| − | | + | |
| − | * If there's something wrong with your patch queue (it says the patch is not in the series or you can't delete a patch) don't forget that you can start over: delete the patches folder with WinSCP and recreate it again in PuTTY using <code>hg qinit -c</code>.
| + | |
| − | | + | |
| − | == Issues With Text Strings ==
| + | |
| − | | + | |
| − | * As <dwuser>denise</dwuser> explained [http://dw-dev-training.dreamwidth.org/13233.html here], you need to delete old text strings and create new ones when you edit .text files or en.dat instead of simply editing the text. If the change isn't critical - the string doesn't need to be renamed or the text change is minor - it's better to notify the site copy team so that text can be changed locally and the original file left alone.
| + | |
| − | | + | |
| − | * If text you've modified doesn't appear on the site after a code push, append <code>?uselang=debug</code> to the page URL to make sure it's using the right string. If it is and it still doesn't display after a while, comment on <dwcomm>dw_maintenance</dwcomm>.
| + | |
| − | | + | |
| − | == Starting Over ==
| + | |
| − | | + | |
| − | * If something's really wrong you can also [[Dreamhack_Troubleshooting#I_want_to_wipe_my_install_and_start_over|rebuild you Dreamhack and start over]].
| + | |
| − | | + | |
| − | | + | |
| − | = References =
| + | |
| − | | + | |
| − | * [http://ss64.com/bash/ Bash commands ]
| + | |
| − | * [http://hgbook.red-bean.com/read/mercurial-queues-reference.html Some HG commands ]
| + | |
| − | | + | |
| − | [[Category:Development]]
| + | |
| − | [[Category:Getting Started]] | + | |
