@@ -408,6 +408,12 @@ Insert file from github

 The main process inside the container will be sent SIGKILL.

+Known Issues (kill)

+~~~~~~~~~~~~~~~~~~~

+

+* :issue:`197` indicates that ``docker kill`` may leave directories

+  behind and make it difficult to remove the container.

+

 .. _cli_login:

 ``login``

@@ -516,6 +522,12 @@ The main process inside the container will be sent SIGKILL.

     Remove one or more containers

         -link="": Remove the link instead of the actual container

+Known Issues (rm)

+~~~~~~~~~~~~~~~~~~~

+

+* :issue:`197` indicates that ``docker kill`` may leave directories

+  behind and make it difficult to remove the container.

+

 Examples:

 ~~~~~~~~~

@@ -10,13 +10,16 @@ Want to hack on Docker? Awesome!

 The repository includes `all the instructions you need to get

 started <https://github.com/dotcloud/docker/blob/master/CONTRIBUTING.md>`_.

-The developer environment `Dockerfile <https://github.com/dotcloud/docker/blob/master/Dockerfile>`_

+The `developer environment Dockerfile

+<https://github.com/dotcloud/docker/blob/master/Dockerfile>`_

 specifies the tools and versions used to test and build Docker.

 If you're making changes to the documentation, see the

 `README.md <https://github.com/dotcloud/docker/blob/master/docs/README.md>`_.

-The documentation environment `Dockerfile <https://github.com/dotcloud/docker/blob/master/docs/Dockerfile>`_

+The `documentation environment Dockerfile

+<https://github.com/dotcloud/docker/blob/master/docs/Dockerfile>`_

 specifies the tools and versions used to build the Documentation.

-Further interesting details can be found in the `Packaging hints <https://github.com/dotcloud/docker/blob/master/hack/PACKAGERS.md>`_.

+Further interesting details can be found in the `Packaging hints

+<https://github.com/dotcloud/docker/blob/master/hack/PACKAGERS.md>`_.

@@ -116,13 +116,13 @@ core concepts of Docker where commits are cheap and containers can be

 created from any point in an image's history, much like source

 control.

-Known Issues

-............

+Known Issues (RUN)

+..................

 * :issue:`783` is about file permissions problems that can occur when

   using the AUFS file system. You might notice it during an attempt to

   ``rm`` a file, for example. The issue describes a workaround.

-

+* :issue:`2424` Locale will not be set automatically.