Changeset View
Changeset View
Standalone View
Standalone View
docs/uri-scheme-browse-revision.rst
| Show First 20 Lines • Show All 41 Lines • ▼ Show 20 Lines | .. http:get:: /browse/revision/(sha1_git)/ | ||||
| .. _dateutil.parser.parse: http://dateutil.readthedocs.io/en/stable/parser.html | .. _dateutil.parser.parse: http://dateutil.readthedocs.io/en/stable/parser.html | ||||
| .. http:get:: /browse/revision/(sha1_git)/log/ | .. http:get:: /browse/revision/(sha1_git)/log/ | ||||
| HTML view that displays the list of revisions heading to | HTML view that displays the list of revisions heading to | ||||
| a given one. In other words, it shows a commit log. | a given one. In other words, it shows a commit log. | ||||
| The following data are displayed for each log entry: | The following data are displayed for each log entry: | ||||
| * author of the revision | |||||
| * link to browse the revision | * link to browse the revision | ||||
| * message associated to the revision | * author of the revision | ||||
| * date of the revision | * date of the revision | ||||
| * link to browse the associated source tree | * message associated to the revision | ||||
| * commit date of the revision | |||||
| By default, the revisions are ordered in reverse chronological order of | |||||
| their commit date. | |||||
| N log entries are displayed per page (default is 20). In order to navigate | N log entries are displayed per page (default is 100). In order to navigate | ||||
| in a large history, two buttons are present at the bottom of the view: | in a large history, two buttons are present at the bottom of the view: | ||||
| * *Newer*: fetch and display if available the N more recent log entries | * *Newer*: fetch and display if available the N more recent log entries | ||||
| than the ones currently displayed | than the ones currently displayed | ||||
| * *Older*: fetch and display if available the N older log entries | * *Older*: fetch and display if available the N older log entries | ||||
| than the ones currently displayed | than the ones currently displayed | ||||
| :param string sha1_git: hexadecimal representation for the *sha1_git* | :param string sha1_git: hexadecimal representation for the *sha1_git* | ||||
| identifier of a SWH revision | identifier of a SWH revision | ||||
| :query string revs_breadcrumb: used internally to store | |||||
| the navigation breadcrumbs (i.e. the list of descendant revisions | |||||
| visited so far). It must be a string in the form | |||||
| "<rev_1>[/<rev_2>/.../<rev_n>]" where rev_i corresponds to a | |||||
| revision sha1_git. | |||||
| :query int per_page: the number of log entries to display per page | :query int per_page: the number of log entries to display per page | ||||
| (default is 20, max is 50) | :query int offset: the number of revisions to skip before returning those to display | ||||
| :query str revs_ordering: specify the revisions ordering, possible values are *committer_date*, | |||||
| *dfs*, *dfs_post* and *bfs* | |||||
| :statuscode 200: no error | :statuscode 200: no error | ||||
| :statuscode 404: requested revision can not be found in the SWH archive | :statuscode 404: requested revision can not be found in the SWH archive | ||||
| **Examples:** | **Examples:** | ||||
| .. parsed-literal:: | .. parsed-literal:: | ||||
| :swh_web_browse:`revision/f1b94134a4b879bc55c3dacdb496690c8ebdc03f/log/` | :swh_web_browse:`revision/f1b94134a4b879bc55c3dacdb496690c8ebdc03f/log/` | ||||
| :swh_web_browse:`revision/d1aa2b3f607b35dc5dbf613b2334b6d243ec2bda/log/` | :swh_web_browse:`revision/d1aa2b3f607b35dc5dbf613b2334b6d243ec2bda/log/` | ||||