Skip to content

Commit 9649452

Browse files
committed
xpm/install updates
1 parent 92aeac9 commit 9649452

File tree

1 file changed

+57
-43
lines changed

1 file changed

+57
-43
lines changed

pages/core/xpm/install.md

Lines changed: 57 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -34,10 +34,22 @@ For details, please read (carefully!) the
3434

3535
{% include important.html content="Please be sure you are installing **xpm** as the **xPack Project Manager**, since there are other projects that unfortunately use the same name (for example _uniX Package Manager_)." %}
3636

37-
## `xpm` install
37+
{% capture uninstall %}
38+
39+
## Uninstall
40+
41+
To remove xpm, the command is:
42+
43+
```sh
44+
npm uninstall --location=global xpm
45+
```
46+
47+
{% endcapture %}
3848

3949
{% capture windows %}
4050

51+
## `xpm` install
52+
4153
On Windows, by default, global Node.js packages are installed in the
4254
user home folder, in `%APPDATA%\npm`
4355
(like `C:\Users\ilg\AppData\Roaming\npm`), and managing packages
@@ -132,6 +144,8 @@ at least for files in the
132144

133145
If this is not possible, temporarily disable the antivirus program.
134146

147+
{{ uninstall | markdownify }}
148+
135149
### xpm clean-ups
136150

137151
For a thorough clean-up, please note that **xpm** uses only two folders:
@@ -145,6 +159,8 @@ They can be removed at any time, and **xpm** will recreate them on new installs.
145159

146160
{% capture macos %}
147161

162+
## `xpm` install
163+
148164
On macOS, by default, global Node.js packages are installed in
149165
`/usr/local`, and managing them requires administrative rights,
150166
but if you followed the instructions in the
@@ -166,6 +182,8 @@ $ xpm --version
166182
{{ page.xpm_version }}
167183
```
168184

185+
{{ uninstall | markdownify }}
186+
169187
### xpm clean-ups
170188

171189
For a thorough clean-up, please note that **xpm** uses only two folders:
@@ -175,10 +193,46 @@ For a thorough clean-up, please note that **xpm** uses only two folders:
175193

176194
They can be removed at any time, and **xpm** will recreate them on new installs.
177195

196+
### macOS specifics
197+
198+
The default location used to install the global packages is
199+
in `~/Library`, a folder that, due to an unfortunate Apple decision,
200+
is hidden for regular browsing in Finder.
201+
202+
To make it back visible, use:
203+
204+
```sh
205+
/usr/bin/chflags nohidden ~/Library
206+
xattr -d com.apple.FinderInfo ~/Library
207+
```
208+
209+
A more general solution is to make all hidden files visible:
210+
211+
```sh
212+
defaults write com.apple.Finder AppleShowAllFiles true
213+
killall Finder
214+
```
215+
216+
Another annoying behaviour of the file browser is to hide names starting
217+
with `.` (dot), which is a real pity since the binary packages are
218+
extracted in a folder named `.content`.
219+
220+
Fortunately there is a workaround for this too:
221+
222+
```console
223+
cmd+shift+'.'
224+
```
225+
226+
This keyboard shortcut works like a toggle, using it once makes files
227+
starting with dot visible,
228+
using it again reverts to hiding them.
229+
178230
{% endcapture %}
179231

180232
{% capture linux %}
181233

234+
## `xpm` install
235+
182236
{% include note.html content="Support for Arm platforms was
183237
added in the 0.6.2 release of xpm." %}
184238

@@ -234,6 +288,8 @@ Follow the instructions in the
234288
[prerequisites]({{ site.baseurl }}/install/) page and update your
235289
`node` & `npm` programs.
236290

291+
{{ uninstall | markdownify }}
292+
237293
### xpm clean-ups
238294

239295
For a thorough clean-up, please note that **xpm** uses only two folders:
@@ -247,14 +303,6 @@ They can be removed at any time, and **xpm** will recreate them on new installs.
247303

248304
{% include platform-tabs.html %}
249305

250-
## Uninstall
251-
252-
To remove xpm, the command is:
253-
254-
```sh
255-
npm uninstall --location=global xpm
256-
```
257-
258306
## Miscellaneous
259307

260308
The official page explaining how to install npm in a custom
@@ -292,40 +340,6 @@ There are two main folders:
292340

293341
For more details see [xpm folders]({{ site.baseurl }}/xpm/folders/).
294342

295-
### macOS specifics
296-
297-
The default location used to install the global packages is
298-
in `~/Library`, a folder that, due to an unfortunate Apple decision,
299-
is hidden for regular browsing in Finder.
300-
301-
To make it back visible, use:
302-
303-
```sh
304-
/usr/bin/chflags nohidden ~/Library
305-
xattr -d com.apple.FinderInfo ~/Library
306-
```
307-
308-
A more general solution is to make all hidden files visible:
309-
310-
```sh
311-
defaults write com.apple.Finder AppleShowAllFiles true
312-
killall Finder
313-
```
314-
315-
Another annoying behaviour of the file browser is to hide names starting
316-
with `.` (dot), which is a real pity since the binary packages are
317-
extracted in a folder named `.content`.
318-
319-
Fortunately there is a workaround for this too:
320-
321-
```console
322-
cmd+shift+'.'
323-
```
324-
325-
This keyboard shortcut works like a toggle, using it once makes files
326-
starting with dot visible,
327-
using it again reverts to hiding them.
328-
329343
## Proxy
330344

331345
If you are behind a firewall, you need to configure

0 commit comments

Comments
 (0)