Skip to content

Commit

Permalink
In Conda documentaton, document that the preferred shell on Windows i…
Browse files Browse the repository at this point in the history
…s Command Prompt and that the environment should be as clean as possible (#850)

* In Conda documentaton, document that the preferred shell is Command Prompt

As some projects have problem in activating their environment in Powershell

* Update conda-forge.md
  • Loading branch information
traversaro authored Aug 7, 2021
1 parent 93dc115 commit 5cbdfbf
Showing 1 changed file with 9 additions and 1 deletion.
10 changes: 9 additions & 1 deletion doc/conda-forge.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,6 +57,10 @@ mamba activate robotologyenv

**IMPORTANT: if you open a new terminal, you need to manually activate the environment also there.**

**IMPORTANT: To avoid strange conflicts in environment variables, it is a good idea to remove from the environment any variable that refers to libraries or software not installed with conda. For example, if you have a robotology-superbuild installed with apt dependencies, it is a good idea to remove the source of the `setup.sh` from the `.bashrc` before using conda environments, or in Windows it can make sense to check with [Rapid Environment Editor](https://www.rapidee.com) that the environment is clean.**

**IMPORTANT: On Windows, it is recommended to use Command Prompt to manage conda environments, as some packages (see https://github.com/conda-forge/gazebo-feedstock/issues/42 and https://github.com/RoboStack/ros-noetic/issues/21) have problems in activating environments on Powershell.**

### Install robotology packages

Once you are in an activated environment, you can install robotology packages by just running the command:
Expand Down Expand Up @@ -114,7 +118,11 @@ mamba activate robsub
~~~

**IMPORTANT: if you open a new terminal, you need to manually activate the environment also there. If you compiled a robotology-superbuild in a given conda environment, remember to activate it before trying to compile or run any package
of the robotology-superbuild.**
of the robotology-superbuild.**

**IMPORTANT: To avoid strange conflicts in environment variables, it is a good idea to remove from the environment any variable that refers to libraries or software not installed with conda. For example, if you have a robotology-superbuild installed with apt dependencies, it is a good idea to remove the source of the `setup.sh` from the `.bashrc` before using conda environments, or in Windows it can make sense to check with [Rapid Environment Editor](https://www.rapidee.com) that the environment is clean.**

**IMPORTANT: On Windows, it is recommended to use Command Prompt to manage conda environments, as some packages (see https://github.com/conda-forge/gazebo-feedstock/issues/42 and https://github.com/RoboStack/ros-noetic/issues/21) have problems in activating environments on Powershell.**

Once you activated it, you can install packages in it. In particular the dependencies for the robotology-superbuild can be installed as:
~~~
Expand Down

0 comments on commit 5cbdfbf

Please sign in to comment.