Explaining code for publication

Software - Practice and Experience

Volumn 33, Issue 10, 2003, Pages 975-1001

  Thimbleby, Harold ^a  

^a UNIVERSITY COLLEGE LONDON   (United Kingdom)

Author keywords

Documentation; Java; Javadoc; LATEX; Literate programming; Loom; Publishing code; Warp; XML

Indexed keywords

ALGORITHMS; CODES (SYMBOLS); COMPUTER SCIENCE; HTML; JAVA PROGRAMMING LANGUAGE; XML;

PUBLISHING CODE;

COMPUTER SOFTWARE;

EID: 0043037228     PISSN: 00380644     EISSN: None     Source Type: Journal    
DOI: 10.1002/spe.537     Document Type: Article

References (76)

1. Deutsch D. The Fabric of Reality. Penguin: London, 1997.
2. Cartwright N. How the Laws of Physics Lie. Oxford University Press: Oxford, 1983.
3. Ziman J. Reliable Knowledge, Canto (ed.). Cambridge University Press: Cambridge, 1991.
4. Abelson H, Sussman GJ, Sussman J. Structure and Interpretation of Computer Programs (1st edn preface). MIT Press: Cambridge, MA, 1985.
5. Perlis AJ. A new policy for algorithms? Communications of the ACM 1966; 9(4):255.
6. Dunham CB. The necessity of publishing programs. Computer Journal 1982; 25(1):61-62.
7. Sedgewick R. Algorithms. Addison-Wesley: Reading MA, 1983.
8. Libes D. Writing a Tcl extension in only 7 years. Proceedings of the Fifth Annual Tcl/Tk Workshop'97, 1997; 14-17.
9. Underhill P. Why We Buy: The Science of Shopping. Texere: New York, 2000.
10. Ladkin PB, Thimbleby H. From logic to manuals. Software Engineering Journal 1997; 11(6):347-354.
11. Ladkin PB, Thimbleby H. From logic to manuals again. IEE Proceedings Software Engineering 1997; 144(3): 185-192.
12. Kuan (Kwan or Guǎn) M-K Graphic programming using odd or even points. Chinese Mathematics 1962; 1:273-277.
13. Lin Y, Zhao Y. A new algorithm for the directed Chinese postman problem. Computers and Operations Research 1988; 15(6):577-584.
14. Chartrand G, Oellermann OR. Applied and Algorithmic Graph Theory. McGraw-Hill: New York, 1993.
15. Skiena S. The Algorithm Design Manual. Springer: Berlin, 1998.
16. Jungnickel D. Graphs, Networks and Algorithms (Algorithms and Computation in Mathematics, vol. 5). Springer: Berlin, 1999.
17. Ahuja RK, Magnanti TL, Orlin JB. Network Flows: Theory, Algorithms, and Applications. Prentice-Hall (Simon and Schuster): Upper Saddle River, NJ, 1993.
18. Dror M (ed.). ARC ROUTING: Theory, Solutions and Applications. Kluwer Academic Publishers: Dordrecht, 2000.
19. Knuth DE. The Art of Computer Programming (3rd edn). Addison-Wesley: Reading, MA, 1997.
20. Porter MF. An algorithm for suffix stripping. Program 1980; 13(3): 130-137.
21. Porter MF. Snowball: A language for stemming algorithms. http://snowball.sourceforge.net/texts/introduction.html[2001].
22. Thimbleby HW. An efficient equivalence class algorithm with applications to autostereograms. Software - Practice & Experience 1996; 26(3):309-325.
23. Thimbleby HW. Using sentinels in insert sort. Software-Practice and Experience 1989; 19(3):303-307.
24. Thimbleby HW. Specification-led design for interface simulation, collecting use-data, interactive help, writing manuals, analysis, comparing alternative designs, etc. Personal Technologies 1999; 4(2):241-254.
25. Thimbleby HW, Cairns P, Jones M. Usability analysis with Markov models. ACM Transactions on Computer Human Interaction 2001; 8(2):99-132.
26. Anderson JR, Lebiere C. The Atomic Components of Thought. Lawrence Erlbaum Associates: Hillsdale, NJ, 1998.
27. MacKenzie D. Mechanizing Proof. MIT Press: Cambridge, MA, 2001.
28. Sterling TD, Weinkam JJ. Sharing scientific data. Communications of the ACM 1990; 33(8):112-119.
29. Feynman RP. Cargo cult science. Surely You're Joking Mr. Feynman!, Hutchings R (ed.). Vintage, 1992.
30. Forsythe GE. Algorithms for scientific computation. Communications of the ACM 1966; 9(4):255-256.
31. Hall RW, Partyka JG. On the road to efficiency. OR/MS Today 1997; 24(3):38-47. http://lionhrtpub.com/orms/orms-6-97/Vehicle-Routing.html.
32. Brown JS, Duguid P. The Social Life of Information. Harvard Business School Press: Boston, MA, 2000.
33. Thimbleby HW. You're right about the cure: Don't do that. Interacting with Computers 1990; 2(1):8-25.
34. Park R. Voodoo Science. Oxford University Press: Oxford, 2000.
35. Adam D, Knight J. Journals under pressure: Publish, and be damned.... Nature 2002; 419(6909):772-776.
36. Simon HA. The Sciences of the Artificial (3rd edn). MIT Press: Cambridge, MA, 1996.
37. Beck K, Gamma E. JUnit. http://www.junit.org/ [2001].
38. Raymond ES. The Cathedral & The Bazaar (Revised edn). O'Reilly: Sebastopol, CA. 2001.
39. Thimbleby H. A critique of Java. Software-Practice & Experience 1999; 29(6):457-478.
40. ACM Code of Ethics and Professional Conduct. http://www.acm.org/constitution/code.html [1992].
41. Thimbleby H. Experiences with literate programming using CWEB (A variant of Knuth's WEB). Computer Journal 1986; 29(3):201-211.
42. Resnik DB. The Ethics of Science. Routledge: London, 1998.
43. Knuth DE, Levy S. The CWEB System of Structured Documentation, Version 3.0. Addison-Wesley: Reading, MA, 1994.
44. Mall D. http://www.literateprogramming.com [2001].
45. Ramsey N, Marceau C. Literate programming on a team project. Software-Practice and Experience 1991; 21(7): 677-683.
46. Knuth DE. Literate programming. Computer Journal 1984; 27(2):97-111.
47. Knuth DE. The Stanford GraphBase. Addison-Wesley: Reading, MA, 1993.
48. Ramsey N. A simple solver for linear equations containing nonlinear operators. Software - Practice & Experience 1996; 26(4):467-487.
49. Artzt E. Autoduck. http://www.literateprogramming.com/autoduck.pdf [2001].
50. Mittelbach F. The doc and shortvrb Packages. Technical Report, Gutenberg Universität Mainz, 1997.
51. Peyton Jones S, Hughes J (eds.). Augustsson L, Barton D, Boutel B, Burton W, Fasel J, Hammond K, Hinze R, Hudak P, Johnsson T, Jones M, Launchbury J, Meijer E, Peterson J, Reid A, Runciman C, Wadler P. Haskell 98: A Non-strict, Purely Functional Language. http://haskell.org/onlinereport [1999].
52. Arnold K, Gosling J, Holmes D. The Java™Programming Language Second Edition (3rd edn). Addison-Wesley: Reading, MA, 2000.
53. Friendly L, The design of distributed hyperlinked programming documentation. Hypermedia Design, Proceedings of the International Workshop on Hypermedia Design (IWHD'95), Fraïssé S, Garzotto F, Isakowitz T, Nanard J, Nanard M (eds.). Springer: Berlin, 1996; 151-173.
54. Queinnec C. Literate Programming from Scheme to TEX. Université Paris 6 & INRIA-Rocquencourt, 2000.
55. Hanson DR, Van Wyk CJ (moderator), Gilbert J (reviewer). Literate programming. Communications of the ACM 1987; 30(7):594-599.
56. Hanson DR. Loom - weave fragments together. loom. 1 in ftp://ftp.cs.princeton.edu/pub/people/drh/loom.tar.gz [1987].
57. Wolfram S. The Mathematica Book (4th edn). Addison-Wesley: Reading, MA, 1999.
58. Thimbleby HW. Specification-led design for interface simulation, collecting use-data, interactive help, writing manuals, analysis, comparing alternative designs, etc. Personal Technologies 1999; 4(2):241-254.
59. Thimbleby HW. Analysis and simulation of user interfaces. BCS Conference on Human-Computer Interaction, vol. XIV, McDonald S, Waern Y, Cockton G (eds.). 2000; 221-237.
60. Ramsey N. Literate programming simplified. IEEE Software 1994; 11(5):97-105.
61. Ramsey N. http://www.eecs.harvard.edu/̃nr/noweb/ [2002].
62. Hanson DR. C Interfaces and Implementations. Addison-Wesley: Reading, MA, 1997.
63. Scowen RS. Some aids for program documentation. Software - Practice & Experience 1977; 7(6):779-792.
64. Goossens M, Rahtz S. The LATX Web Companion. Addison Wesley: Reading, MA, 1999.
65. Van Wyk CJ. Literate programming: An assessment. Communications of the ACM 1990; 33(3):361, 365.
66. Harold R, Means WS. XML In a Nutshell. O'Reilly: Sebastopol, CA, 2001.
67. Tidwell D. Mastering XML Transformations: XSLT. O'Reilly: Sebastopol, CA, 2001.
68. Microsoft Corporation. Getting Started: Microsoft Office, Document No. OF64076-0295, 1992-1994.
69. Addison MA, Thimbleby H. Intelligent adaptive assistance and its automatic generation. Interacting with Computers 1996; 8(1):51-68.
70. Ladkin PB, Thimbleby H. A proper explanation when you need one. BCS Conference HCI'95, People and Computers, vol. X, Kirby MAR, Dix AJ, Finlay JE (eds.). Cambridge University Press: Cambridge, 1995; 107-118.
71. Thimbleby HW. Java: A critique. Software-Practice & Experience 1999; 29(5):457-478.
72. Thimbleby HW. Calculators are needlessly bad. International Journal of Human-Computer Studies 2000; 52(6): 1031-1069.
73. Braune B, Wilhelm R. Focusing in algorithm explanation. IEEE Transactions on Visualization and Computer Graphics 2000; 6(1):1-7.
74. Ovsiannikov IA, Arbib MA, Mcneill TH. Annotation technology. International Journal of Human-Computer Studies 2000; 50(4):329-362.
75. Phelps TA, Wilensky R. Multivalent documents. Communications of the ACM 2000; 43(6):83-90.
76. Knuth DE. Foreword. A = B, Petkowvšek M, Wilf HS, Zeilberger D (eds.). A K Peters: Wellesley, MA, 1996.