Comments (9)
On Wed, Jan 21, 2015 at 06:22:55PM -0800, Raniere Silva wrote:
Windows doesn't have
man
installed. To improve the experience of
our students that use Windows machines we should usecommand --help
instead ofman command
and make a few changes in the write
version of our shell lesson.
- In
06-find.md
, replaceman grep
withgrep --help
.
Ugh. Can't we just suggest they use the web to get the man page?
E.g. 1. We may be able to script that up in a little man stub using
Python's webbrowser 2 and install the script using our Windows
installer. For Git, it doesn't matter if you use ‘man’ or ‘--help’,
but on my system grep(1) is 649 lines of useful explanation (e.g. it
talks about character classes, bracket expressions, regexp anchoring,
…) and ‘grep --help’ is 76 lines of compact usage information.
from shell-novice.
Can't we just suggest they use the web to get the man page?
I'm OK with using the web. This is just a suggestion that @dbarneche gave me.
from shell-novice.
Learners frequently can't get on wireless during workshops, either
because they're from a different institution, or because university
wireless can't handle the load, or just because. We should therefore
tell people about both man
and google.
from shell-novice.
On Thu, Jan 22, 2015 at 04:57:54AM -0800, Greg Wilson wrote:
Learners frequently can't get on wireless during workshops, either
because they're from a different institution, or because university
wireless can't handle the load, or just because. We should
therefore tell people about bothman
and google.
So I'd tell leaners:
- Use ‘man’ if you have it, since it's easy to run and gives detailed
advice. If you don't have it, fall back to… - A man page (or other docs if you can find them) posted online.
More work to find, but you get man-page-quality advice. If you
don't have network access or can't find the appropriate docs, fall
back to… - ‘--help’, which will usualy get you the command syntax. That may
be enough to jog your memory. If you're lucky (e.g for Git), the
--help will be as useful (or exactly the same as ;) the man page
;).
And I'd leave it up to instructors to gloss over any bits they felt
weren't pertinent to their class (e.g. don't mention ‘man’ if all your
students are Windows users who are masochistically learning about the
POSIX shell ;).
from shell-novice.
I updated the description of this issue since I believe that we could agree with @wking's last comment.
from shell-novice.
This is also referenced in (old) PR #24.
from shell-novice.
Should we add a link to the GNU Bash site man page? https://www.gnu.org/software/bash/manual/
We might want to add this link to either the shell lessons, the instructor notes, or the workshop template.
from shell-novice.
Yes please, PR's welcome :)
from shell-novice.
Resolved.
from shell-novice.
Related Issues (20)
- Glossary "shell" term has a broken anchor link in its text HOT 1
- removing unneeded files solution not quite right HOT 1
- Link to installation instructions points to a workshop template HOT 6
- Use consistent path settings
- Other Options for Finding Files in Episode 7
- Where do we get 1518 files? HOT 1
- Broken link to regex lesson HOT 6
- Consider moving callout about long/short options
- macOS now uses Zsh as default shell HOT 2
- Grammar Mistake in "07-find.md" at "Matching and Subtracting" solution.
- A detail in Unix Shell Pipes and Filters Lesson HOT 3
- Ep. 02: Link to Glossary not resolved
- Ep. 05: Remove redundant paragraphs HOT 1
- Broken link in list of external resources HOT 1
- Missing spaces between words HOT 2
- Broken link in Reference HOT 1
- Clarify statement "the total count of each type of animal" in "Pipes and filters" challenge HOT 1
- Checkout Recommendation for Trainee HOT 4
- Note that we are directing people to an Incubator (un-official) lesson HOT 1
- Unix Shell Script, Finding things, Tractknig a species, grep -r HOT 1
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from shell-novice.