Graphics Interface '82 304

Total Page:16

File Type:pdf, Size:1020Kb

Graphics Interface '82 304 303 ON THE GRAPHIC DESIGN OF PROGRAM TEXT Aaron Marcus Lawrence Berkeley Laboratory University of California Berkeley, California 94720 USA Ronald Baecker Human Computing Resources Corporation 10 St. Mary Street Toronto, Ontario M4Y IP9 ABSTRACT Computer programs, like literature, deserve attention not o nly to conc eptual and ver­ bal (linguistic) structure but also to visual structure, i .e., the qualitities of al­ phanumeric text fonts and other graphic symbols, the spatial arrangement of isolated texts and symbols, the temporal sequencing of individual parts of the program, and the use of col or (including gray values). With the increasing numbers of programs of ever greater complexity, and with the widespread availability of high resolution raster displays, both soft copy and hard copy, it is essential and possible to enhance signi­ ficantly the graphic design of program text. The paper summarizes relevant principles from information-oriented graphic design, especially book design, and shows how a standard C program might be translated into a well-designed typographic version. The paper's intention is to acquaint the computer graphics community with the available and relevant concepts, literature, and exper­ tise, and to demonstrate the great potential f or the graphic design of computer pro­ grams. INTRODUCTION Three other relevant developments should be noted. First, many programs have After three decades of continucus and in grown longer , more complicated , and im­ some cases revolutionary development of penetrable to e ven skilled programmers. computer hardware and software systems, Second, programmers themselves have con­ one aspect of computer technology has tinued to be nomadic, often shifting shown resilience to change: the presenta­ jobs, inheriting programs fr om others and tion of computer programs themselves. passing on a legacy of programs to still Even though computer graphics systems others. Third, the number of non­ have achieved dynamic, color, and multi­ professional programmers, i.e., hobby­ font display capabilities, the visual ists, occasional programmers, or those qualities of alphanumeric and graphic without formal degrees in computer sci­ symbols of program code has remained re­ ence, has increased considerably . Thus latively simple. There are limited exten­ there is an increasing need for more ef­ sions of symbols in some languages, e.g., fective, more productive means to create in APL, and some attempts to visually and maintain programs . Software engineer­ structure the page with simple indenta­ ing has recognized iri a numbe r of ways tions for control statements and groups that programming is a kind of literature of code lines. There are also more ela­ which requires good writing. The most borate schemes such as Nassi-Schneiderman widespread development has been the con­ diagrams [Nassi], Warnier-Orr diagrams cern with the logical structure and e x­ [Higgins], contour diagrams [Organick] , pressive style of programs. Out of this and SADT diagrams [ROSS]; however, the concern have em erged many of the modern typographic repertoire and appearance of software developmen t techniques, includ­ programs often remains little changed ing top-design design and stepwise re­ from the manner in which teletypewr iters finement [Wirth], structured programmi ng first printed out programs. [Dahl], modularity [Parnas], and softwar e tools [Kernighan] . Another kind of Graphics Interface '82 304 development has occurred in the organi za­ A potenti a lly symbi o tic relatio n ~ hip ex­ tion of the editoral and production team ist s between graphic design a nd computer that produces the writing, for example, g r a phics in c reating the "thr ee f aces" of the concepts of Chief Programmer Tea ms c om puter systems : outer-faces, in ter­ [Baker] and Structured Walkthroughs faces, and i nner-faces (Ma rcus 1981b] . [Yourdon] • A third more recent develop­ Ou ter- f ac es are t he end display p roducts ment is the increase of interest in or-aat a pro cessing: images of informatio n enhancing the technology to support the such as texts, tables, charts , maps, and writing and maintaining of good programs, diagrams . Inter-faces are the user­ by providing, for example, integrated oriented hu.man=iii'ac'FiI'i1einterf ace s used t o software development environments create outer-faces . These inter-faces are [Wasserman] and high-performance personal compr ised of frames (online) and pages workstations specialized to the task of (offline) of process c o n trol, data struc­ program development [Teitelman, Deutsch, tures , a nd their documentation. ~­ Gutz] . faces a re the frames and pages of source ~ programs and documentation which Unfortunately, there is yet another ap­ bui lders a nd maintai ners o f computer sys­ proach to improving program writing and tems require in order to s uppor t the maintenance which also recognizes pro­ i nter-faces and o uter-faces. By c o mbin­ grams as literature but which has been ing intuitive, practical skills and systematically ignored. This approach scientifi c knowledge, graphic designers concerns the visible language in which can help synthesize prototype s o lutions textual information is embodied. for any of t h e three face s and assist in analyzing and developing finished Books embody literature. Graphic d isplays which are not merely ' pretty' , designers of books are concerned with le­ but wh ich communicate infor mat ion better . gibility and readability, i.e., func­ tionality and appeal to the reader. It In other articles (Marcus 1980, Marcus seems reasonable that computer programs 198 1a], the primary author has explained viewed as literature can be reformulated t he relationship of graphic design to in typographic and graphic formats to outer-faces and inter-faces. This present better convey the content of well-written article extends the relevance of g raphic programs. By adopting the model of book design t o inner-faces, to the design of literature, computer science can adapt programs as texts, and suggests further and apply the expertise available from directions f or research in program visu­ graphic design. a lization. In order to emphasize book­ o rien ted graphic design principles that are mo st relevant to the graphic design GRAPHIC DESIGN AND COMPUTER GRAPHICS o f inner-faces, most of the discuss ion will focus on the display of a single Graphic design is a discipline concerned frame o r page rather than the with portraying facts, concepts, and emo­ viewer/reader's response to an inte rac­ tions, as well as the logic of space and tiv e display. time (structure and process) in effective visible language. Information-oriented graphic design in particular is familiar VISUAL PARAMETERS with the concept of algorithms, for much FOR PROGRAM VISUALIZATION of its work involves specifying algo­ rithms for visual parameters to convey The graphic design of prog rams requires complex information. Traditionally, the d esigner to select s ymbols and for­ graphic designers have worked in printed mats for the primar y components of pro­ media such as books, charts, diagrams , grams : variables, constants, logical and maps. There is considerable profes­ str uctures, processes, commentary, and sional literature [Tinker, Zachrisson, documen tation aids. Num erous c hoices ex­ Hartley, Williamson] dealing with the ist fo r layout grid s, t ypographic styles, subjects of typographic legibi l ity, spa­ s ize and spacing of text lines, organiza­ tial composition, sequencing of pages , tion of lists, and other means of visual organization of content, us e o f col o r , emphasis. Explicit dec isions on these and use of illustrative mater ial . Thi s matters are usually unspecified in the discipline and its literature have original conception of programming knowledge appropriate to and helpful for languages. The graphic designer can now the task of designing ver bal/ visual specify them us ing the principles of displays for computer technology. s i milarity, proximity, c larity, con- Graphics Interface '82 305 sistency, and simplicity [Marcus 1980) as Within a typeface family, r egular (ro­ a guide to organizing all the visual man), italic, and bold roman are standard parameters into effective and attractive means of increasing emphasis. Unless a frames or pages. great amount of effort is expended on the design of characters, adapt ions of well­ These graphic design specifications con­ established typefaces such as Times Ro­ stitute a visual/verbal algorithm for the man, Helvetica, Garamond, universe, etc. construction of frames and pages. Program should be used. Frame presentations allow visualization should facilitate learning for reversed video characters, blinking, of the program text, aid memorization of variable intensities, and other means of its features, encourage concentrated at­ emphasis. These should be used sparingly tention, and assist in revealing a clear because of their strength of differentia­ conceptual structure, especially in si­ tion from normal text. Type size varia­ tuations where the viewer/reader may be tion should be limited to at most three distracted or poorly motivated. sizes for text materials, and these sizes should be quickly and easily dis­ Traditional literature on typographic le­ tinguished. Generally 9 or 10 point type gibility [Rehe) and book design [Hartley, for a 14 inch viewing distance is stan­ Williamson) concern printed texts rather dard printed text size. Optimum size than computer graphics displays. However, will vary with the detailed characteris­ many of the principles would appear to be tics of a display device and the viewing transferable to the computer graphics en­ situation. Column widths should be limit­ vironment. The following principles are ed to allow 40-60 characters per line based on this literature and the primary [Rehe). In the interrupted texts of pro­ author's own professional experience as a grams, lines are usually unjustified on graphic designer in both traditional and the right and a 'ragged right' approach computer-based media.
Recommended publications
  • Bash . . Notes, Version
    2.2 Quoting and literals 4. ${#var} returns length of the string. Inside single quotes '' nothing is interpreted: 5. ${var:offset:length} skips first offset they preserve literal values of characters enclosed characters from var and truncates the output Bash 5.1.0 notes, version 0.2.209 within them. A single (strong) quote may not appear to given length. :length may be skipped. between single quotes, even when escaped, but it Negative values separated with extra space may appear between double (weak) quotes "". Remigiusz Suwalski are accepted. ey work quite similarly, with an exception that the 6. uses a default value, if shell expands any variables that appear within them ${var:-value} var August 19, 2021 is empty or unset. (pathname expansion, process substitution and word splitting are disabled, everything else works!). ${var:=value} does the same, but performs an assignment as well. Bash, a command line interface for interacting with It is a very important concept: without them Bash the operating system, was created in the 1980s. splits lines into words at whitespace characters – ${var:+value} uses an alternative value if 1 (Google) shell style guide tabs and spaces. See also: IFS variable and $'...' var isn’t empty or unset! and $"..." (both are Bash extensions, to be done). e following notes are meant to be summary of a 2.4.4 Command substitution style guide written by Paul Armstrong and too many Avoid backticks `code` at all cost! To execute commands in a subshell and then pass more to mention (revision 1.26). 2.3 Variables their stdout (but not stderr!), use $( commands) .
    [Show full text]
  • ANSI® Programmer's Reference Manual Line Matrix Series Printers
    ANSI® Programmer’s Reference Manual Line Matrix Series Printers Printronix, LLC makes no representations or warranties of any kind regarding this material, including, but not limited to, implied warranties of merchantability and fitness for a particular purpose. Printronix, LLC shall not be held responsible for errors contained herein or any omissions from this material or for any damages, whether direct, indirect, incidental or consequential, in connection with the furnishing, distribution, performance or use of this material. The information in this manual is subject to change without notice. This document contains proprietary information protected by copyright. No part of this document may be reproduced, copied, translated or incorporated in any other material in any form or by any means, whether manual, graphic, electronic, mechanical or otherwise, without the prior written consent of Printronix, LLC Copyright © 1998, 2012 Printronix, LLC All rights reserved. Trademark Acknowledgements ANSI is a registered trademark of American National Standards Institute, Inc. Centronics is a registered trademark of Genicom Corporation. Dataproducts is a registered trademark of Dataproducts Corporation. Epson is a registered trademark of Seiko Epson Corporation. IBM and Proprinter are registered trademarks and PC-DOS is a trademark of International Business Machines Corporation. MS-DOS is a registered trademark of Microsoft Corporation. Printronix, IGP, PGL, LinePrinter Plus, and PSA are registered trademarks of Printronix, LLC. QMS is a registered
    [Show full text]
  • Logical Segmentation of Source Code
    Logical Segmentation of Source Code Jacob Dormuth, Ben Gelman, Jessica Moore, David Slater Machine Learning Group Two Six Labs Arlington, Virginia, United States E-mail: fjacob.dormuth, ben.gelman, jessica.moore, [email protected] Abstract identifying where to generate automatic comments, and lo- cating useful sub-function boundaries for bug detection. Many software analysis methods have come to rely on Current approaches to segmentation do not intentionally machine learning approaches. Code segmentation - the pro- capture logical content that could improve its usefulness to cess of decomposing source code into meaningful blocks - the aforementioned problems. Traditionally, code segmen- can augment these methods by featurizing code, reducing tation has been done at a syntactic level. This means that noise, and limiting the problem space. Traditionally, code language-specific syntax, such as the closing curly brace of segmentation has been done using syntactic cues; current a class or function, is the indicator for a segment. Although approaches do not intentionally capture logical content. We this method is conceptually simple, the resulting segments develop a novel deep learning approach to generate logical do not intentionally take into account semantic information. code segments regardless of the language or syntactic cor- Syntactic structures in natural language, such as sentences rectness of the code. Due to the lack of logically segmented and paragraphs, are generally also indicators of semantic source code, we introduce a unique data set construction separation. In other words, two different paragraphs likely technique to approximate ground truth for logically seg- capture two logically separate ideas, and it is simple to de- mented code.
    [Show full text]
  • SNL Final Report
    SNL Final Report BY James Lin AleX Liu AndrE Paiva Daniel Maxson December 17 2014 Contents 1 INTRODUCTION 1 1.1 INTRODUCTION . .1 1.2 Motivation . .1 1.3 Why CALL IT Stage (null) language? . .1 2 Language TUTORIAL 2 2.1 Compilation WALKTHROUGH . .2 2.1.1 Compiler Setup . .2 2.1.2 Compile SNL TO Java . .2 2.1.3 Compile SNL TO Java ExECUTABLE . .2 2.2 Stages . .3 2.3 Recipes . .3 2.4 VARIABLES . .3 2.5 Lists . .3 2.6 ContrOL FloW . .4 2.7 Input/Output . .4 3 Language ReferENCE Manual 5 3.1 LeXICAL Elements . .5 3.1.1 Comments . .5 3.1.2 IDENTIfiERS........................................5 3.1.3 KeYWORDS . .5 3.1.4 LiterALS . .5 3.1.5 OperATORS . .6 3.1.6 SeperATORS . .6 3.1.7 White Space . .6 3.2 Data TYPES . .7 3.2.1 TYPING . .7 3.2.2 Built-in Data TYPES . .7 3.3 ExprESSIONS AND OperATORS . .7 3.4 Recipes . .8 I 3.4.1 Recipe DefiNITIONS . .8 3.4.2 Calling Recipes . .8 3.5 PrOGRAM StructurE AND Scope . .9 3.5.1 PrOGRAM StructurE . .9 3.5.2 Stages . .9 3.5.3 Scope . .9 4 PrOJECT Plan 10 4.1 PrOJECT PrOCESSES . 10 4.1.1 Planning . 10 4.1.2 SpecifiCATION . 10 4.1.3 DeVELOPMENT . 10 4.1.4 TESTING . 10 4.2 Style Guide . 11 4.3 TEAM Responsibilities . 11 4.4 PrOJECT Timeline . 12 4.5 DeVELOPMENT EnvirONMENT . 12 4.6 PrOJECT Log . 12 5 ArCHITECTURAL Design 13 5.1 OvervieW .
    [Show full text]
  • Cleiej Author Instructions
    CLEI ELECTRONIC JOURNAL, VOLUME 21, NUMBER 1, PAPER 5, APRIL 2018 Attributes Influencing the Reading and Comprehension of Source Code – Discussing Contradictory Evidence Talita Vieira Ribeiro and Guilherme Horta Travassos PESC/COPPE/UFRJ – Systems Engineering and Computer Science Program, Federal University of Rio de Janeiro, Rio de Janeiro, Brazil, 21941-972 {tvribeiro, ght}@cos.ufrj.br Abstract Background: Coding guidelines can be contradictory despite their intention of providing a universal perspective on source code quality. For instance, five attributes (code size, semantic complexity, internal documentation, layout style, and identifier length) out of 13 presented contradictions regarding their influence (positive or negative) on the source code readability and comprehensibility. Aims: To investigate source code attributes and their influence on readability and comprehensibility. Method: A literature review was used to identify source code attributes impacting the source code reading and comprehension, and an empirical study was performed to support the assessment of four attributes that presented empirical contradictions in the technical literature. Results: Regardless participants’ experience; all participants showed more positive comprehensibility perceptions for Python snippets with more lines of code. However, their readability perceptions regarding code size were contradictory. The less experienced participants preferred more lines of code while the more experienced ones preferred fewer lines of code. Long and complete-word identifiers presented better readability and comprehensibility according to both novices and experts. Comments contribute to better comprehension. Furthermore, four indentation spaces dominated the code reading preference. Conclusions: Coding guidelines contradictions still demand further investigation to provide indications on possible confounding factors explaining some of the inconclusive results. Keywords: Source code quality, Readability, Comprehensibility, Experimental Software Engineering.
    [Show full text]
  • Identifying Javascript Skimmers on High-Value Websites
    Imperial College of Science, Technology and Medicine Department of Computing CO401 - Individual Project MEng Identifying JavaScript Skimmers on High-Value Websites Author: Supervisor: Thomas Bower Dr. Sergio Maffeis Second marker: Dr. Soteris Demetriou June 17, 2019 Identifying JavaScript Skimmers on High-Value Websites Thomas Bower Abstract JavaScript Skimmers are a new type of malware which operate by adding a small piece of code onto a legitimate website in order to exfiltrate private information such as credit card numbers to an attackers server, while also submitting the details to the legitimate site. They are impossible to detect just by looking at the web page since they operate entirely in the background of the normal page operation and display no obvious indicators to their presence. Skimmers entered the public eye in 2018 after a series of high-profile attacks on major retailers including British Airways, Newegg, and Ticketmaster, claiming the credit card details of hundreds of thousands of victims between them. To date, there has been little-to-no work towards preventing websites becoming infected with skimmers, and even less so for protecting consumers. In this document, we propose a novel and effective solution for protecting users from skimming attacks by blocking attempts to contact an attackers server with sensitive information, in the form of a Google Chrome web extension. Our extension takes a two-pronged approach, analysing both the dynamic behaviour of the script such as outgoing requests, as well as static analysis by way of a number of heuristic techniques on scripts loaded onto the page which may be indicative of a skimmer.
    [Show full text]
  • Learning a Metric for Code Readability Raymond P.L
    TSE SPECIAL ISSUE ON THE ISSTA 2008 BEST PAPERS 1 Learning a Metric for Code Readability Raymond P.L. Buse, Westley Weimer Abstract—In this paper, we explore the concept of code readability and investigate its relation to software quality. With data collected from 120 human annotators, we derive associations between a simple set of local code features and human notions of readability. Using those features, we construct an automated readability measure and show that it can be 80% effective, and better than a human on average, at predicting readability judgments. Furthermore, we show that this metric correlates strongly with three measures of software quality: code changes, automated defect reports, and defect log messages. We measure these correlations on over 2.2 million lines of code, as well as longitudinally, over many releases of selected projects. Finally, we discuss the implications of this study on programming language design and engineering practice. For example, our data suggests that comments, in of themselves, are less important than simple blank lines to local judgments of readability. Index Terms—software readability, program understanding, machine learning, software maintenance, code metrics, FindBugs ✦ 1 INTRODUCTION its sequencing control (e.g., he conjectured that goto unnecessarily complicates program understanding), and E define readability as a human judgment of how employed that notion to help motivate his top-down easy a text is to understand. The readability of a W approach to system design [9]. program is related to its maintainability, and is thus a key We present a descriptive model of software readability factor in overall software quality.
    [Show full text]
  • Flycheck Release 32-Cvs
    Flycheck Release 32-cvs Aug 25, 2021 Contents 1 Try out 3 2 The User Guide 5 2.1 Installation................................................5 2.2 Quickstart................................................7 2.3 Troubleshooting.............................................8 2.4 Check buffers............................................... 12 2.5 Syntax checkers............................................. 14 2.6 See errors in buffers........................................... 18 2.7 List all errors............................................... 22 2.8 Interact with errors............................................ 24 2.9 Flycheck versus Flymake........................................ 27 3 The Community Guide 33 3.1 Flycheck Code of Conduct........................................ 33 3.2 Recommended extensions........................................ 34 3.3 Get help................................................. 37 3.4 People.................................................. 37 4 The Developer Guide 45 4.1 Developer’s Guide............................................ 45 5 The Contributor Guide 51 5.1 Contributor’s Guide........................................... 51 5.2 Style Guide................................................ 54 5.3 Maintainer’s Guide............................................ 57 6 Indices and Tables 63 6.1 Supported Languages.......................................... 63 6.2 Glossary................................................. 85 6.3 Changes................................................. 85 7 Licensing 93 7.1 Flycheck
    [Show full text]
  • Evolution of Fortran Standards Over the Few Decades
    Evolution of Fortran standards over the few A brief overview of this course decades Advanced Fortran Programming concentrates on aspects The 1st version became a standard by John Backus related to the most recent versions of the Fortran (IBM/1957) standard (F2003/2008/2015) Mid-60’s the most significant version was labeled as an – some Fortran 95 less-known features are covered, too ANSI standard, called FORTRAN66 Our major F2003/F2008 subjects in this course are In 1978 the former “de-facto” FORTRAN77 standard was – Language interoperability approved and quickly became popular, contained e.g. – Object-oriented Fortran (OOF) – IMPLICIT statement – Parallel programming with Fortran coarrays – IF – THEN – ELSE IF – ELSE – ENDIF – CHARACTER data type – PARAMETER statement for specifying constants 1 2 Evolution of Fortran standards… Evolution of Fortran standards… An important extension to FORTRAN77 was release of A major step in keeping Fortran programming alive was “military standard” Fortran enhancements (also in 1978) introduction of the Fortran 90 standard in ’91 (ISO), ’92 by US DoD, and adopted by most FORTRAN77 compilers (ANSI) – IMPLICIT NONE – Free format source input (up to 132 characters per line) – DO – END DO – Dynamic memory handling – INCLUDE statement Marked a number of features obsolescent (but did not – Bit manipulation functions delete any features), e.g. All these were eventually incorporated to the next major – Arithmetic IF and computed GOTO statements official standard release – Fortran 90 – Alternate RETURN, and use of H in FORMAT statements 3 4 Evolution of Fortran standards… Evolution of Fortran standards… A minor revision in 1997 (ISO) some features were taken Fortran 2003 was a significant revision of the Fortran 95 from High Performance Fortran (HPF) specification, e.g.
    [Show full text]
  • Draft: Work in Progress
    Draft: Work in Progress Modified for the General Mission Analysis Tool (GMAT) Project Linda Jun &Wendy Shoan (Code 583) Last Updated: 2005105124 Table of Contents 1 Introduction 1.I Purpose 1.2 Audience 1.3 Interpretation 2 Names 2.1 Class Names Class Library Names Class Instance Names MethodlFunction Names MethodIFunction Argument Names Namespace Names Variables 2.7.1 Pointer Variables 2.7.2 Reference Variables 2.7.3 Global Variables Type Names Enum Type Names and Enum Names Constants I#define Structure Names C Function Names C++ File Names Generated Code File Names 3 Formatting 3.1 Variables 3.2 Brace 3.3 Parentheses () 3.4 Indentation 3.5 Tab I Space 3.6 Blank Lines 3.7 MethodIFunction Arguments 3.8 If IIf else 3.9 Switch 3.10 For 1While 3.11 Break 3.12 Use of goto 3.13 Useof?: 3.14 Return Statement 3.15 Maximum Characters per Line 4 Documentation 4.1 Header File Prolog 4.2 Header File Pure Virtual MethodIFunction Prolog 4.3 Source File Prolog 4.4 Source File MethodIFunction Prolog 4.5 Comments in General 5 Class 5.1 Class Declaration (Header File) 5.1 .I Required ~ethodsfor a Class 5.1.2 Class MethodIFunction Declaration Layout 5.1.3 Include 5.1.4 lnlining 5.1.5 Class Header File Layout 5.2 Class Definition (Source File) 5.2.1 Constructors 5.2.2 Exceptions 5.2.3 Class MethodIFunction Definition Layout 5.2.4 Class Source File Layout 6 Templates 7 Prosram Files 9 Efficiencv 10 Miscellaneous 10.1 Extern Statements IExternal Variables 10.2 Preprocessor Directives 10.3 Mixing C and C++ 10.4 CVS Keywords 10.5 README file 10.6 Makefiles 10.7 Standard Libraries 10.8 Use of Namespaces 10.9 Standard Template Library (STL) 10.1 0 Using the new Operator Appendix A Code Examples Appendix B Doxvaen Commands 1 Introduction This document is based on the "C Style Guide" (SEL-94-003).
    [Show full text]
  • How to Present More Readable Text for People with Dyslexia
    Univ Access Inf Soc (2017) 16:29–49 DOI 10.1007/s10209-015-0438-8 LONG PAPER How to present more readable text for people with dyslexia 1 2,3 Luz Rello • Ricardo Baeza-Yates Published online: 20 November 2015 Ó Springer-Verlag Berlin Heidelberg 2015 Abstract The presentation of a text has a significant Keywords Dyslexia Á Eye tracking Á Textual effect on the reading speed of people with dyslexia. This accessibility Á Text customization Á Recommendations Á paper presents a set of recommendations to customize texts Readability Á Text color Á Background color Á Font size Á on a computer screen in a more accessible way for this Character, line and paragraph spacings Á Column width target group. This set is based on an eye tracking study with 92 people, 46 with dyslexia and 46 as control group, where the reading performance of the participants was 1 Introduction measured. The following parameters were studied: color combinations for the font and the screen background, font Dyslexia is a neurological reading disability which is size, column width as well as character, line and paragraph characterized by difficulties with accurate and/or fluent spacings. It was found that larger text and larger character word recognition and by poor spelling and decoding abili- spacings lead the participants with and without dyslexia to ties. Secondary consequences may include problems in read significantly faster. The study is complemented with reading comprehension and reduced reading experience that questionnaires to obtain the participants’ preferences for can impede growth of vocabulary and background knowl- each of these parameters, finding other significant effects.
    [Show full text]
  • Appendix 1: C Style Analysis
    Appendix 1: C Style Analysis The features of a program that contribute to its 'elegance' are very much subjective, and often instinctive. A superficial analysis of a program's 'style' (that is, its visual presentation), while not being the only factor, is certainly an indicative, and easily automated, component. Presented here is a program that performs a textual analysis of a C program, yielding a percentage 'style score'. The code is also available on a floppy diskette - see the Introduction for details. STYLE ANALYSIS The features that contribute to the style score are based on proposals made by Rees (1982), adapted for C rather than Pascal: Module length The average length, in non-blank lines, of function definitions; functions that are prolific and too short tend to obscure the program logic, while those that are too long are difficult to dismember. Identifier length The average length, in characters, of user identifiers; brief identifier names (such as i or c) are often meaningless, while overlong names make the program verbose (most programmers will know that selection of pithy, meaningful identifier names is often one of the most time consuming elements of writing code). Comments The percentage of all lines that contain comments; over-commenting is as much a sin as under­ commenting; some comments, however, are always necessary, even in the shortest of programs. Indentation The ratio of initial spaces to total number of characters; indentation can be used to good effect to indicate the program structure. Blank lines The percentage of all lines that are blank; blank lines 154 Appendix 1: C Style Anarysis 155 separate functional units of a program.
    [Show full text]