upstream/ipython Files · docs/source/whatsnew/pr/hist-range-glob-feature.rst

better doc

Daniel Goldfarb - - Load All Authors

File last commit:

r26368:0e53bd9d


                r26474:c4fd963f

Download file

             hist-range-glob-feature.rst
        
                    25 lines
            
             | 790 B
            
                | text/x-rst
            
             |
                RstLexer
            
             / docs / source / whatsnew / pr / hist-range-glob-feature.rst
          
                    History
                
                 |
                  Source
                 | Raw
                 |Copy content
                 |Copy permalink

        Daniel Goldfarb
    
add whatsnew/pr rst file

              r26366
            
      History Range Glob feature

      ==========================

        Daniel Goldfarb
    
fix some formatting in rst file.

              r26368
            
      Previously, when using ``%history``, users could specify either

        Daniel Goldfarb
    
add whatsnew/pr rst file

              r26366
            
      a range of sessions and lines, for example:

        Daniel Goldfarb
    
fix some formatting in rst file.

              r26368
            
      .. code-block:: python

        Daniel Goldfarb
    
add whatsnew/pr rst file

              r26366
            
        Daniel Goldfarb
    
fix some formatting in rst file.

              r26368
            
         ~8/1-~6/5   # see history from the first line of 8 sessions ago,

                     # to the fifth line of 6 sessions ago.``

        Daniel Goldfarb
    
add whatsnew/pr rst file

              r26366
            
        Daniel Goldfarb
    
fix some formatting in rst file.

              r26368
            
      Or users could specify a glob pattern:

        Daniel Goldfarb
    
add whatsnew/pr rst file

              r26366
            
        Daniel Goldfarb
    
fix some formatting in rst file.

              r26368
            
      .. code-block:: python

         -g <pattern>  # glob ALL history for the specified pattern.

      However users could *not* specify both.  

      If a user *did* specify both a range and a glob pattern,

      then the glob pattern would be used (globbing *all* history) *and the range would be ignored*.

      ---

      With this enhancment, if a user specifies both a range and a glob pattern, then the glob pattern will be applied to the specified range of history.

	Site-wide shortcuts
/	Use quick search box
g h	Goto home page
g g	Goto my private gists page
g G	Goto my public gists page
g 0-9	Goto bookmarked items from 0-9
n r	New repository page
n g	New gist page

	Repositories
g s	Goto summary page
g c	Goto changelog page
g f	Goto files page
g F	Goto files page with file search activated
g p	Goto pull requests page
g o	Goto repository settings
g O	Goto repository access permissions settings
t s	Toggle sidebar on some pages

Daniel Goldfarb add whatsnew/pr rst file	r26366	History Range Glob feature
		==========================

Daniel Goldfarb fix some formatting in rst file.	r26368	Previously, when using ``%history``, users could specify either
Daniel Goldfarb add whatsnew/pr rst file	r26366	a range of sessions and lines, for example:

Daniel Goldfarb fix some formatting in rst file.	r26368	.. code-block:: python
Daniel Goldfarb add whatsnew/pr rst file	r26366
Daniel Goldfarb fix some formatting in rst file.	r26368	~8/1-~6/5 # see history from the first line of 8 sessions ago,
		# to the fifth line of 6 sessions ago.``
Daniel Goldfarb add whatsnew/pr rst file	r26366
Daniel Goldfarb fix some formatting in rst file.	r26368	Or users could specify a glob pattern:
Daniel Goldfarb add whatsnew/pr rst file	r26366
Daniel Goldfarb fix some formatting in rst file.	r26368	.. code-block:: python

		-g <pattern> # glob ALL history for the specified pattern.

		However users could not specify both.

		If a user did specify both a range and a glob pattern,
		then the glob pattern would be used (globbing all history) and the range would be ignored.

		---

		With this enhancment, if a user specifies both a range and a glob pattern, then the glob pattern will be applied to the specified range of history.