obs_basic_workflow: explain how to "move" a file

Fixes: #236

Signed-off-by: Nathan Cutler <[email protected]>

xml/obs_basic_workflow.xml

@@ -154,14 +154,15 @@
  <sect1 xml:id="sec.obs.basicworkflow.create-new">
   <title>Creating a New Package</title>
   <para>
-   This section covers how to create packages from a project hosted on &gh;
-   (the <quote>upstream project</quote>). We assume that this project contains source code
-   which you want to package for different &suse; distributions.
+   This section covers how to create packages from an arbitrary software project,
+   which we will refer to here as the <quote>upstream project</quote>. We
+   assume that this project contains source code
+   which you want to package for one or more &suse; (openSUSE) distributions.
    We assume the setup of your home project in your &obsa; instance is
    already done. If not, refer to <xref linkend="sec.obs.basicworkflow.setuphome"/>.
   </para>
   <para>
-   To create a package from an upstream project, do the following:
+   To create a package from the upstream project, do the following:
   </para>
   <procedure>
    <title>General Procedure to Build a RPM Package</title>
@@ -312,6 +313,35 @@ Fri Aug 23 08:42:42 UTC 2017 - &exampleuser_mail;</screen>
     <screen>&prompt.user;<command>osc</command> commit</screen>
    </step>
   </procedure>
+  <para>
+   To delete a file in your working directory, merely deleting it from the local
+   filesystem ("rm FILENAME") is probably not going to be sufficient, since
+   <command>osc</command>, like any other Source Code Control System, expects
+   the file to be there. If you really want to delete a file, use the command:
+   <command>osc delete</command>.
+  </para>
+  <para>
+   While there is no dedicated <command>osc</command> to "move" (rename) a file,
+   the desired end result can be obtained using the following procedure:
+  </para>
+  <procedure>
+   <title>Procedure for Moving a File within a Locally Checked-out OBS Package</title>
+   <step>
+    <para>
+     Copy the file to the new name
+    </para>
+   </step>
+   <step>
+    <para>
+     <command>osc delete</command> the original file
+    </para>
+   </step>
+   <step>
+    <para>
+     <command>osc add</command> the new file.
+    </para>
+   </step>
+  </procedure>
  </sect1>
 
  <sect1 xml:id="sec.obs.basicworkflow.builderrors">