Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Configuration docs refresh #4492

Merged
merged 16 commits into from Nov 7, 2013
Merged

Configuration docs refresh #4492

merged 16 commits into from Nov 7, 2013

Conversation

takluyver
Copy link
Member

As @minrk pointed out in #4475, our config docs said a lot about how the config system worked, and not enough about how to use it. Here, I have:

  • Moved the technical details of the config system into the development directory.
  • Added a new 'intro' document describing how to use the config system, without the technical info.
  • Autogenerate lists of config options for the main components (this doesn't yet include the parallel machinery).
  • Condense and tidy up other config docs, removing outdated information.

ipython --help
ipython notebook --help
# etc.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

One word on precedence of CL options over config files ?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good idea, done.

@Carreau
Copy link
Member

Carreau commented Nov 5, 2013

+1

\\w {cwd} current working directory
\\W {cwd_last} basename of CWD
\\Xn {cwd_x[n]} Show the last n terms of the CWD. n=0 means show all.
\\Yn {cwd_y[n]} Like \Xn, but show '~' for $HOME
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

tabs and spaces, maybe?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It was, yes. I've made it all spaces now.

@minrk
Copy link
Member

minrk commented Nov 7, 2013

Looks great, thanks!

minrk added a commit that referenced this pull request Nov 7, 2013
Configuration docs refresh

- Moved the technical details of the config system into the development directory.
- Added a new 'intro' document describing how to use the config system, without the technical info.
- Autogenerate lists of config options for the main components (this doesn't yet include the parallel machinery).
- Condense and tidy up other config docs, removing outdated information.
@minrk minrk merged commit e33abb3 into ipython:master Nov 7, 2013
@takluyver takluyver deleted the docs-refresh branch November 8, 2013 00:44
mattvonrocketstein pushed a commit to mattvonrocketstein/ipython that referenced this pull request Nov 3, 2014
Configuration docs refresh

- Moved the technical details of the config system into the development directory.
- Added a new 'intro' document describing how to use the config system, without the technical info.
- Autogenerate lists of config options for the main components (this doesn't yet include the parallel machinery).
- Condense and tidy up other config docs, removing outdated information.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants