Loading...
Helix SwarmHelix Swarm
Loading...

p4db_help.html

  • //
  • guest/
  • diane_holt/
  • p4db/
  • htdocs/
  • p4db_help.html #1
  • View
  • Commits
  • Open Download .zip Download (24 KB) 
  1. <!doctype html public "-//w3c//dtd html 4.0 transitional//en">
  2. <html>
  3. <head>
  4.    <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
  5.    <meta name="GENERATOR" content="Mozilla/4.5 [en] (X11; I; Linux 2.0.35 i686) [Netscape]">
  6.    <meta name="Author" content="holtdl@yahoo.com">
  7.    <meta name="Description" content="Information on how to use P4DB">
  8.    <title>HELP file for P4DB</title>
  9. </head>
  10. <body>
  11.  
  12. <center><font size=+2><b>Help for P4DB</b></font></center>
  13. <p>
  14. <center><font size=+2><b>The Perforce Depot Browser</b></font></center>
  15.  
  16. <p>
  17. <font size=+2><b>Overview</b></font>
  18. <br>
  19. P4DB is a browser that allows you to explore a Perforce
  20. source-code repository
  21. (&#147;depot&#148;). P4DB lets you list the source-tree 
  22. directories, examine files, display information about changes, do
  23. &#147;diff&#148;s of file revisions, labels,
  24. etc.
  25. P4DB does not allow you to affect the depot
  26. &#151;
  27. you can use it to display information, but you can't change
  28. anything with it.
  29. <p>
  30. <font size=+1><b>The P4DB Home Page</b></font><br>
  31. &nbsp;&nbsp;&nbsp;&nbsp;<a href=#HI>Header Information</a><br>
  32. &nbsp;&nbsp;&nbsp;&nbsp;<a href=#BDT>Browse Depot Tree</a><br>
  33. &nbsp;&nbsp;&nbsp;&nbsp;<a href=#PC>Pending Changes</a><br>
  34. &nbsp;&nbsp;&nbsp;&nbsp;<a href=#LB>List Branches</a><br>
  35. &nbsp;&nbsp;&nbsp;&nbsp;<a href=#LL>List Labels</a><br>
  36. &nbsp;&nbsp;&nbsp;&nbsp;<a href=#LU>List Users</a><br>
  37. &nbsp;&nbsp;&nbsp;&nbsp;<a href=#SFF>Search for file</a><br>
  38. &nbsp;&nbsp;&nbsp;&nbsp;<a href=#VCF>View changes for file</a><br>
  39. &nbsp;&nbsp;&nbsp;&nbsp;<a href=#VCN>View change number</a><br>
  40. &nbsp;&nbsp;&nbsp;&nbsp;<a href=#BDR>Browse a different repository</a><br>
  41. &nbsp;&nbsp;&nbsp;&nbsp;<a href=#LCB>List Changes by Branch</a><br>
  42. &nbsp;&nbsp;&nbsp;&nbsp;<a href=#LOF>List Opened Files</a><br>
  43. &nbsp;&nbsp;&nbsp;&nbsp;<a href=#LCU>List Changes by User</a><br>
  44. &nbsp;&nbsp;&nbsp;&nbsp;<a href=#GH>Get Help</a><br>
  45. &nbsp;&nbsp;&nbsp;&nbsp;<a href=#GSR>The Great Submit Race</a><br>
  46. &nbsp;&nbsp;&nbsp;&nbsp;<a href=#ML>Mail</a><br>
  47. <font size=+1><b>General Information About Viewing Files and File Data</b></font><br>
  48. &nbsp;&nbsp;&nbsp;&nbsp;<a href=#DCF>Displaying the Contents of a File</a><br>
  49. &nbsp;&nbsp;&nbsp;&nbsp;<a href=#DFD>Displaying File Data</a><br>
  50. <font size=+1><b>Frequently Asked Questions</b></font><br>
  51. &nbsp;&nbsp;&nbsp;&nbsp;<a href=#FAQ>The P4DB FAQ</a><br>
  52. <br>
  53. <table width=100% border=0>
  54. <tr valign=center>
  55. <td width=5%>
  56. <img height=22 src=../icons/hand_point3.gif>
  57. <td width=95%>
  58. The term <i>Legend</i> refers to the gray area at the top of each page.
  59. <td width=5%>
  60. </table>
  61. <p>
  62. <a name=HI><b><font size=+1>Header Information</font></b></a>
  63. <br>
  64. <b>Current change number</b> is the number of the most recent change that was
  65. submitted. This number is also the default value for the
  66. <a href=#VCN>View change number</a>
  67. form
  68. &#151;
  69. to see the details for the latest change, click on the gray area of the
  70. <b>View change number</b>
  71. form.
  72. <p>
  73. <b>Host</b> is the name of the machine the daemon for the P4 server you
  74. are accessing is running on;
  75. <b>Port</b> is the port number the daemon is listening on.
  76. <p>
  77.  
  78. <a name=BDT><b><font size=+1>Browse Depot Tree</font></b></a>
  79. <br>
  80. Clicking on <b>Browse Depot Tree</b> will display the
  81. <i>Depot Tree Browser</i>
  82. page, which allows you to
  83. &#147;walk the source-tree&#148;.
  84. If the P4 source repository has more than one depot,
  85. accessing the
  86. <i>Depot Tree Browser</i>
  87. page from the P4DB homepage will display a list of the
  88. depots. Selecting a depot from this page will then display
  89. a list of the subdirectories and files at the top of that
  90. depot. If the repository has only one depot,
  91. accessing the
  92. <i>Depot Tree Browser</i>
  93. page from the P4DB homepage will display a list of the
  94. subdirectories and files at the top of the depot.
  95. As indicated in the Legend
  96. for the
  97. <i>Depot Tree Browser</i>
  98. page, clicking on a subdirectory listed on the page
  99. will display a list of the
  100. subdirectories and files at that directory level, and so on.
  101. If files are listed at the
  102. current directory level, clicking on a filename will display the
  103. <i>File Log</i>
  104. page, which contains the P4 filelog (revision history) information for
  105. that file.
  106. See the
  107. <a href=#FLP>File Log Page</a>
  108. section for details.
  109. <p>
  110. The <b>Back to</b> line on the
  111. <i>Depot Tree Browser</i>
  112. page allows you to
  113. climb back up the directory tree without having
  114. to do it a directory at a time. You can click on any one of the
  115. directory elements and go directly to that directory.
  116. For example, if you are currently at the
  117. <tt>//depot/main/docs/intranet/arch</tt>
  118. directory level and want to return to <tt>//depot/main</tt>, click on the
  119. <b>/main</b> element on the <b>Back to</b> line.
  120. <p>
  121. The 
  122. <i>Depot Tree Browser</i>
  123. Legend also contains two
  124. &#147;action&#148;
  125. options.
  126. The
  127. <b>View changes for all files below this point</b>
  128. option will display a list of all the changes that have been
  129. submitted on files in the current directory and on any files in any 
  130. subdirectories of the current directory. Selecting this option will
  131. display the
  132. <i>Change History</i>
  133. page.
  134. As the Legend on the
  135. <i>Change History</i>
  136. page indicates, clicking on the change number
  137. will display the
  138. <i>Change <tt>&lt;number&gt;</tt></i>
  139. page, which contains the details
  140. of that change.
  141. Refer to the section on
  142. <a href=#VCN>View change number</a>
  143. for more information regarding the
  144. <i>Change <tt>&lt;number&gt;</tt></i>
  145. page.
  146. <p>
  147. The <b>Hide deleted files</b> option is a
  148. &#147;toggle&#148;
  149. that will either hide or
  150. show deleted files. If the current display includes files that have a
  151. line through them, this indicates these files have been
  152. &#147;deleted&#148;
  153. (via a
  154. <b><i>p4 delete</b></i>).
  155. To see the files in this directory without
  156. the deleted files being shown, click on
  157. <b>Hide deleted files</b>.
  158. The files
  159. that had been displayed with lines through them will no longer appear,
  160. and the
  161. &#147;action&#148;
  162. option will change to
  163. <b>Show deleted files</b>.
  164. Click on this option again to redisplay the deleted files.
  165. <p>
  166. <b><i>Note:</i></b>
  167. The
  168. &#147;toggle&#148;
  169. will stay in its current
  170. state until you click on it again. That is,
  171. if you click on another directory, and
  172. &#147;hiding deleted files&#148;
  173. is the current state (the Legend contains
  174. <b>Show deleted files</b>),
  175. then any subsequent directory
  176. listings will not show (<i>i.e.</i>,will be
  177. &#147;hiding&#148;)
  178. deleted files until you
  179. &#147;toggle&#148;
  180. the state by clicking on
  181. <b>Show deleted files</b>.
  182. <p>
  183. <a name=PC><b><font size=+1>Pending Changes</font></b></a>
  184. <br>
  185. Clicking on <b>Pending Changes</b> will display a list of the changes,
  186. for all current P4 users,
  187. that have been assigned a P4 change number but have not yet been submitted.
  188. If you want to see only the pending
  189. changes for a specific user, you can use the
  190. <b><i>View pending changes only for</i></b>
  191. form at the top of the
  192. <i>Pending Changes</i>
  193. page.
  194. A list of all the current P4 users is provided
  195. &#151;
  196. click on either the
  197. &#147;down arrow&#148;
  198. or inside the box to get the list, then
  199. select the name of the user you want to see pending changes for, and click
  200. on <b>Go</b>.
  201. <p>
  202. As indicated in the Legend for the
  203. <i>Pending Changes</i>
  204. page, clicking on a pending change number will
  205. display the
  206. <i>Change <tt>&lt;number&gt;</tt></i>
  207. information page, which contains the
  208. details of that pending change.
  209. (Refer to the section on
  210. <a href=#VCN>View change number</a>
  211. for more information regarding the
  212. <i>Change <tt>&lt;number&gt;</tt></i>
  213. page.)
  214. <p>
  215. <a name=LB><b><font size=+1>List Branches</font></b></a>
  216. <br>
  217. Clicking on <b>List Branches</b> will display a list of all the branches
  218. that have been created for this repository,
  219. along with information about each branch.
  220. As indicated in the Legend on the
  221. <i>P4 Branches</i>
  222. page, clicking on the name of the owner of the branch
  223. will display the P4 user information.
  224. Clicking on the left-side mapping path
  225. on the <b>View</b> line
  226. will display a list of all the changes that have been put through for
  227. all the files in and below that directory.
  228. Clicking on the right-side mapping path
  229. will display a list
  230. of all the changes that have been put through for the branch.
  231. <p>
  232. <a name=LL><b><font size=+1>List Labels</font></b></a>
  233. <br>
  234. Clicking on <b>List Labels</b> will display a list of all
  235. the labels that have been created for this repository,
  236. along with the date the label was created
  237. and the label description.
  238. As the Legend for the
  239. <i>P4 Labels</i>
  240. page indicates, clicking on the label name will display the
  241. <i>Label Information</i>
  242. page,
  243. which contains the full label specification, Legend
  244. &#147;action&#148;
  245. options, and forms that allow you
  246. to:
  247. <blockquote>
  248. <li>
  249. diff the current label against another label, with options to limit the diff
  250. <li>
  251. view the changes for the current label, while excluding another label
  252. <li>
  253. search for files in this label
  254. </blockquote>
  255. <p>
  256. The
  257. <b>View changes for <i>label_name</i></b> Legend
  258. &#147;action&#148;
  259. option allows you to display a list of all the changes that
  260. have been submitted for files included on this label.
  261. The
  262. <b>List files in <i>label_name</i></b>
  263. option allows you to display a list of all the files that are included
  264. on this label.
  265. <b><i>Caution</i>:</b>
  266. Some labels can contain many thousands of filenames, so getting
  267. a full list of the files on a label can be fairly slow and
  268. local-resource intensive.
  269. <p>
  270. The
  271. <b>Diff with label</b>
  272. form allows you to select a label to diff against the current one.
  273. The
  274. <b>Show files that</b>
  275. form allows you to limit the files displayed from the diff to:
  276. <blockquote>
  277. <li>
  278. just those files that
  279. <b>are not modified</b> between the two labels (files
  280. that exist on both labels, and at the same revisions);
  281. <li>
  282. just those files that
  283. <b>are modified</b>
  284. between the two labels (files
  285. that exist
  286. on both labels, but at different revisions);
  287. <li>
  288. just those files that
  289. <b>differ</b> between the two labels (files that exist
  290. only on one or the other label, but not both).
  291. </blockquote>
  292. You can combine these options in any way you choose. For example,
  293. to see a list of all the files in common between the two labels
  294. but that are at different revisions, as well as all the files that exist
  295. on only one or the other of the labels, turn on both the
  296. <b>are modified</b>
  297. and the
  298. <b>differ</b>
  299. options. (This is the default setting when you first access this page.)
  300. <p>
  301. If you turn off all these options, the
  302. <i>Label Diff</i>
  303. page will display only the label specifications for the two labels,
  304. a file count for each label, and a count of the number of files the
  305. two labels have in common, including a count of those at the same
  306. revision numbers.
  307. <p>
  308. The
  309. <b>View changes for <i>label_name</i> excluding label</b>
  310. form allows you to display a list of all the changes that
  311. have been submitted for the files on the current label,
  312. <i>except</i>
  313. those
  314. changes that also occur on the excluded label.
  315. <p>
  316. The
  317. <b>Search in label for</b>
  318. form allows you to search the label for files that match
  319. the pattern you specify. The pattern can be either a specific
  320. filename, or it can be specified using the P4 wildcards
  321. &#147;<b>&#133;</b>&#148; and &#147;<b>*</b>&#148;.
  322. (Refer to the
  323. <a href=#SFF>Search for file</a>
  324. section for more details regarding using wildcards.)
  325. <p>
  326. <a name=LU><b><font size=+1>List Users</font></b></a>
  327. <br>
  328. Clicking on
  329. <b>List Users</b>
  330. will display the list of all current P4 users.
  331. As indicated in the Legend for the
  332. <i>P4 Users</i>
  333. page,
  334. clicking on the email address will generate a mail message to that user.
  335. To send mail to all the current P4 users,
  336. select the
  337. <b>Mail all users</b>
  338. Legend
  339. &#147;action&#148;
  340. option.
  341. <p>
  342. Clicking on the user name will display the
  343. <i>P4 User Information</i>
  344. page,
  345. which contains the user information as well as
  346. a list of all the files currently opened by that user.
  347. As the Legend for the
  348. <i>P4 User Information</i>
  349. page indicates, clicking on the email address will
  350. generate a mail message to that user. Clicking on the
  351. filename of an opened file will display the filelog
  352. for that file.
  353. The Legend also contains an
  354. &#147;action&#148;
  355. option that allows you to display a list of the user's clients.
  356. <i>Note</i>:
  357. Because of an oversight in the output of the
  358. <b><i>p4 clients</i></b>
  359. command, generating a list of a clients owned by a particular
  360. user is a somewhat lengthy process, so expect it to take a
  361. minute or two to complete. Selecting the
  362. <b>Display user's clients</b>
  363. option will redisplay the
  364. <i>P4 User Information</i>
  365. page with the list of clients included. Note that the Legend
  366. now also indicates that clicking on a client name will display
  367. the P4 client information.
  368. <p>
  369. <a name=SFF><b><font size=+1>Search for file</font></b></a>
  370. <br>
  371. This form allows you to search the source-tree for files that match
  372. the pattern you specify. The pattern can be either a specific
  373. filename, or it can be specified using the P4 wildcards
  374. &#147;<b>&#133;</b>&#148; and &#147;<b>*</b>&#148;.
  375. For example:
  376. <blockquote>
  377. <li>
  378. To find all the files named
  379. <tt>build.jam</tt>
  380. under the
  381. <tt>//depot/main</tt>
  382. directory and all its subdirectories, enter:
  383. <blockquote>
  384. <tt>//depot/main/...build.jam</tt>
  385. </blockquote>
  386. <li>
  387. To find all the
  388. <tt>build.jam</tt>
  389. files that live only in a direct subdirectory of
  390. <tt>//depot/main/java</tt>,
  391. enter:
  392. <blockquote>
  393. <tt>//depot/main/java/*/build.jam</tt>.
  394. </blockquote>
  395. <li>
  396. To find all the files throughout the entire repository that end with
  397. <tt>.java</tt>,
  398. enter:
  399. <blockquote>
  400. <tt>//...*.java</tt>
  401. </blockquote>
  402. <li>
  403. To find all the files that live in directories with
  404. &#147;doc&#148;
  405. in the directory name, enter:
  406. <blockquote>
  407. <tt>//.../*doc*/...</tt>
  408. </blockquote>
  409. </blockquote>
  410. The results of the search are displayed on the
  411. <i>Search Results</i>
  412. page, which includes the number of files found that match the pattern,
  413. the list of files found, and, if the search resulted in more than
  414. one file being found, a
  415. <b>View diff between</b>
  416. form that allows you to diff any two of
  417. the files listed. The default values for this form
  418. are the first and second files listed.
  419. <p>
  420. <a name=VCF><b><font size=+1>View changes for file</font></b></a>
  421. <br>
  422. This
  423. form allows you to display the changes for files that match
  424. the pattern you specify. The pattern can be either a specific
  425. filename, or it can be specified using the P4 wildcards
  426. &#147;<b>&#133;</b>&#148; and &#147;<b>*</b>&#148;.
  427. (Refer to the
  428. <a href=#SFF>Search for file</a>
  429. section for more details regarding using wildcards.)
  430. <p>
  431. <a name=VCN><b><font size=+1>View change number</font></b></a>
  432. <br>
  433. This form allows you to specify a change number to see the details
  434. of that particular change. The default value for this form is the
  435. change number of the most recently submitted change.
  436. To see the details for the default change number, click on the gray
  437. area of the
  438. <b>View change number</b>
  439. form.
  440. <p>
  441. The details of the change are displayed on the
  442. <i>Change <tt>&lt;number&gt;</tt></i>
  443. page. This page contains:
  444. <blockquote>
  445. <li>
  446. the name of the P4 user who submitted the change,
  447. <li>
  448. the name of the P4 client that was used,
  449. <li>
  450. the date the change was submitted (or last modified),
  451. <li>
  452. the description of the change, and
  453. <li>
  454. the P4 Jobs the change fixed (if implemented).
  455. </blockquote>
  456. Below this is the list of the files that comprised the change.
  457. <p>
  458. As the
  459. Legend for this page indicates, clicking on the user's name will display
  460. the P4 user information. Clicking on the action will display the diff
  461. the change generated for that file. Clicking on the revision number will
  462. display the contents of that file at that revision. Clicking on the
  463. filename will display a P4 filelog for that file.
  464. <p>
  465. If more than one file was submitted for the change, the
  466. <b>Diff all files in change</b>
  467. option will be displayed at the end of the list of files.
  468. Selecting this option will display the
  469. <i>Diff Output</i>
  470. page, which will contain the diffs for each file included
  471. in the change.
  472. <p>
  473. Also included on the
  474. <i>Change <tt>&lt;number&gt;</tt></i>
  475. page, directly below the legend, is the option to either
  476. go to the previous change, or the next change (unless
  477. this change is the latest submitted change).
  478. <p>
  479. <a name=BDR><b><font size=+1>Browse a different repository</font></b></a>
  480. <br>
  481. This form allows you to browse a different repository
  482. by entering either a new host name or new port number,
  483. or both, in order to change the P4 server you are accessing.
  484. For example,
  485. if you want to access the source repository at Perforce that is
  486. available to the public, enter
  487. <tt>public.perforce.com</tt>
  488. in the left-hand side of the form.
  489. If the port number, in the right-hand side of
  490. the form, is already set to
  491. <tt>1666</tt>,
  492. click on
  493. <b>Go</b>; otherwise, first change
  494. the port number to
  495. <tt>1666</tt>,
  496. then click on
  497. <b>Go</b>.
  498. <p>
  499. <a name=LCB><b><font size=+1>List Changes by Branch</font></b></a>
  500. <br>
  501. Clicking on
  502. <b>List Changes by Branch</b>
  503. will display a list of all the 
  504. branches in the repository. As indicated in the Legend on the
  505. <i>Changes by Branch</i>
  506. page, clicking on one of the branch names
  507. will display a list of all the changes that have been submitted
  508. into that branch. To see a list of only those changes submitted
  509. by a specific user, use the
  510. <b><i>View branch changes only for</i></b>
  511. form at the top of the page.
  512. A list of all the current P4 users is provided
  513. &#151;
  514. click on either the
  515. &#147;down arrow&#148;
  516. or inside the box to get the list, then
  517. select the name of the user you want to see pending changes for, and click
  518. on <b>Go</b>.
  519. <p>
  520. <b><i>Note:</i></b>
  521. If you know the branch path,
  522. you could also see the branch changes by clicking on
  523. <b>Browse Depot Tree</b>,
  524. then working your way through directories on the
  525. <i>Depot Tree Browser</i>
  526. pages to get to the branch path, and selecting the
  527. <b>View changes for all files below this point</b>
  528. option to see the same list of changes
  529. &#151;
  530. <b>List Changes by Branch</b>
  531. is offered as a short-cut, as well as offering the option to
  532. list branch changes only for a specific user.
  533. <p>
  534. <a name=LOF><b><font size=+1>List Opened Files</font></b></a>
  535. <br>
  536. Clicking on
  537. <b>List Opened Files</b>
  538. will display a list of all the currently opened (via a
  539. <b><i>p4 add</i></b>,
  540. <b><i>p4 delete</i></b>,
  541. or
  542. <b><i>p4 edit</i></b>
  543. command), for all users, in all clients. To see only the opened
  544. files for a specific client, use the
  545. <b><i>View opened files only for client:</i></b>
  546. form at the top of the list of files.
  547. <p>
  548. As indicated by the Legened for the
  549. <i>Opened Files</i>
  550. page, clicking on the revision number will display the contents
  551. of that file at that revision, clicking on the user name will
  552. display the P4 user information for that user, clicking on the
  553. client name will display the P4 client information for that client,
  554. and clicking on the filename will display the filelog for that file.
  555. For any file that has a change
  556. <i>number</i>
  557. (rather than
  558. <tt>(default)</tt>)
  559. in the
  560. <b>Change</b>
  561. column, you can click on that change number to see the details
  562. of that (pending) change.
  563. <p>
  564. <a name=LCU><b><font size=+1>List Changes by User</font></b></a>
  565. <br>
  566. Clicking on
  567. <b>List Changes by User</b>
  568. will display a list of all the 
  569. current P4 users. As indicated in the Legend on the
  570. <i>Changes by User</i>
  571. page, clicking on one of the user names
  572. will display a list of all the changes that have been submitted
  573. by that user. As indicated by the Legend on the
  574. <i>Change History</i>
  575. page, click on a change number to display the
  576. <i>Change <tt>&lt;number&gt;</tt></i>
  577. page and see the details of that change.
  578. (Refer to the section on
  579. <a href=#VCN>View change number</a>
  580. for more information regarding the
  581. <i>Change <tt>&lt;number&gt;</tt></i>
  582. page.)
  583. <p>
  584. <a name=GH><b><font size=+1>Get Help</font></b></a>
  585. <br>
  586. Click on
  587. <b>Get Help</b>
  588. to access this help page.
  589. <p>
  590. <a name=GSR><b><font size=+1>The Great Submit Race</font></b></a>
  591. <br>
  592. Have fun!
  593. &#133;
  594. <p>
  595. <a name=ML><b><font size=+1>Mail</font></b></a>
  596. <br>
  597. If you have any questions or concerns about the P4 source tree
  598. (<i>e.g.</i>, some
  599. branch looks wrong, is obsolete, a file isn't showing up where it should be,
  600. etc.), click on
  601. <b>P4 Administrator</b>
  602. to send mail.
  603. <p>
  604. If you have questions, suggestions, problems, bugs to report, etc. about
  605. P4DB itself, click on
  606. <b>P4DB Administrator</b>
  607. to send mail.
  608. <p>
  609. <a name=DCF><font size=+1><b>Displaying the Contents of a File</b></font></a>
  610. <br>
  611. <b><i>Revision Number</i></b>
  612. <br>
  613. On any page that includes a revision number for a file, click on the
  614. revision number to see the text of the file at that revision. The
  615. contents of the file will be displayed on the
  616. <i>File View</i>
  617. page. The Legend for this page varies, depending on the type of
  618. file being displayed.
  619. Some types of files can be displayed as their
  620. end-product rather than their source.
  621. The following file extensions are treated by P4DB
  622. as specially viewable files:
  623. <blockquote>
  624. <li>
  625. .html and .htm for HTML files
  626. <li>
  627. .gif for GIF files
  628. <li>
  629. .jpeg and .jpg for JPEG files
  630. <li>
  631. .doc for MS-Word files
  632. <li>
  633. .dot for MS-Word Template files
  634. <li>
  635. .ppt for MS-PowerPoint files
  636. <li>
  637. .pdf for PDF files
  638. <li>
  639. .rtf for RTF files
  640. </blockquote>
  641. <p>
  642. For example, if you are viewing
  643. the source-file for an HTML file, the Legend will contain four
  644. &#147;action&#148;
  645. options. Select the
  646. <b>View HTML file using browser</b>
  647. option to display the file
  648. as it would appear if you brought it up in your
  649. browser as a URL.
  650. Select the
  651. <b>About Links and the HTML File Viewer</b>
  652. option to
  653. display a short explanation of how links are handled
  654. by the HTML file viewer.
  655. <p>
  656. For all except binary files, you can click on the
  657. <b>View line-by-line history trace</b>
  658. option to display the file
  659. as output from the
  660. <b><i>p4pr</i></b>
  661. utility, which produces an audit of the file,
  662. showing for each line the change number,
  663. who made the change, and at
  664. what revision the line was changed.
  665. <p>
  666. All file types offer the 
  667. the
  668. <b>Download file</b>
  669. &#147;action&#148;
  670. option. Select this option to save the file locally.
  671. <p>
  672. <a name=DFD><font size=+1><b>Displaying File Data</b></font></a>
  673. <br>
  674. <b><i>Change Number</i></b>
  675. <br>
  676. On any page that includes a change number for the file, click on the
  677. change number to see the details of that change.
  678. <p>
  679. <b><i>Action</i></b>
  680. <br>
  681. On any page that includes an action for the file, click on the action
  682. to see the diffs that action generated.
  683. <p>
  684. <b><i>Filename</i></b>
  685. <br>
  686. On any page that includes a filename, click on the filename to see a
  687. P4 filelog (revision history) for that file.
  688. <p>
  689. <a name=FLP><b><i>The </i>File Log<i> Page</i></b></a>
  690. <br>
  691. The
  692. <i>File Log</i>
  693. page displays the revision history of a file.
  694. As the Legend for the
  695. <i>File Log</i>
  696. page indicates, clicking on a change number will display the
  697. details of that change. Clicking on an action will display the
  698. diffs that were generated by that change.
  699. Clicking on a revision number will display the contents of the
  700. file at that revision. Clicking on the user who submitted the
  701. change will display the P4 user information for that user.
  702. <p>
  703. Also included in the
  704. <i>File Log</i>
  705. page Legend are two
  706. &#147;action&#148;
  707. options. The
  708. <b>Changes</b>
  709. option will display the
  710. <i>Change History</i>
  711. page, which will contain a list of all the changes that have
  712. been submitted that included this file.
  713. The
  714. <b>List labels</b>
  715. option will redisplay the
  716. <i>File Log</i>
  717. page, additionally displaying information
  718. about any labels this file is included on.
  719. <p>
  720. The
  721. <i>File Log</i>
  722. page also includes a form that allows you to diff two revisions
  723. of the file. The default setting for the
  724. <b>Show diff between revision</b>
  725. form is the latest revision and the next-to-latest revision.
  726. To change the revision numbers, click on either the
  727. &#147;down arrow&#148;
  728. or inside the box to get the list of revision numbers, then
  729. click on
  730. <b>Go</b>.
  731. <p>
  732. <a name=FAQ><font size=+1><b>P4DB FAQ</b></font></a>
  733. <br>
  734. At this point, there isn't one. If you have any questions about how to
  735. use P4DB that haven't been covered by this help page, you are welcome
  736. to send mail to the P4DB Administrator
  737. &#151;
  738. click on
  739. <b>P4DB Administrator</b>
  740. on the
  741. <b>Mail</b>
  742. line at the bottom of any P4DB page.
  743. The FAQ for P4DB will grow as questions about it come up.
  744. <p>
  745. </body>
  746. </html>
  747.  
# Change User Description Committed
#1 269 Diane Holt The P4DB help file. 25 years ago