DOCSLIB.ORG

Bash . . Notes, Version

Total Page：16

File Type：pdf, Size：1020Kb

Download full-text PDF Read full-text
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) . Bash is the only shell scripting language permitted Variable names are case sensitive. ey can contain (To group them without new shell, use { cmds }.) for executables. Bash should only be used for simple digits and underscores as well, but a name starting 2.4.5 Arithmetic expansion wrapper scripts or small utilities. with a digit is not allowed. Example: e arithmetic expression $(( ...)) is evaluated Executables should have no extension, libraries var="kind" and expands to the result. Bash guarantees that the must have a .sh extension and should not be echo ${var}ness # kindness output will be a one-word integer. Exit code is zero executable. SUID and SGID are forbidden on shell () output is nonzero. scripts. Special variables: 2.4.6 Process substitution All error messages should go to STDERR, a function 1. $0: name of the script itself. is kind of substitution: and to print out error messages along with other status 2. $1, $2, ...: the first, second, etc. argument. <( ... ) >( ... ) (not specified by POSIX!), where input or output of a information is recommended: shift removes first argument and advances rest of them forward. command appears as a temporary file, is performed err () { 3. $* and $@ denote all positional parameters simultaneously with the following: arithmetic and echo "[$(date +%Y-%m-%d\%T) ]: $@" >&2 ($*: as a single word, $@: as separate strings). parameter expansions, command substitution. } 4. $#: the number of positional parameters. 2.4.7 Word splitting 5. $?: exit status of last executed command. Comments. Start each file with a description of its 2.4.8 File name expansion contents. Any function that is in a library or not both 6. $$: the process ID of the shell. obvious and short, must be commented. Comment 7. $!: the process ID of last executed command. Glob patterns (composed of normal characters and , , ) are not regular expressions! Bash tricky, interesting or important parts of code. Use 2.4 Expansions * ? [...] TODO comments for temporary or good enough but supports extended globs too (X(list) where X is not perfect code and short-term solutions. Eight expansions happen ater splitting command one from ?*+@!). into tokens, in the order that they are expanded. e following are required for any new code: 2.5 Streams 2.4.1 Brace expansion ere are always three default files open: 1. Indent 2 spaces, no tabs. Brace expansion is used when we need to generate 2. Maximum line length is 80 characters. all possible string combinations. Both of the 1. stdin (the keyboard, file descriptor 0), 3. Long pipelines should be split one per line. commands produce the same output: 2. stdout (the screen, file descriptor 1) and 4. Indent case alternatives by 2 spaces. 3. stderr (error messages, file descriptor 2). 5. Always quote strings containing variables, echo {I,really,love,dots}. spaces, command substitutions or shell meta echo I. really. love. dots. ese streams can be redirected: characters, unless unquoted expansion is Warning: it does not expand the variables ($var), 1. cmd > file redirects to a file (overwrites), required. which is done later, but supports ranges (sequences) 2. cmd >> file appends instead, Use quotes rather than filler characters if possible. of characters: 3. m>n (m>&n) redirects a file descriptor to a file Use an explicit path when doing wildcard expansion (or another file descriptor), echo {a..t} 4. redirects stdout and stderr to a file, of filenames. Avoid eval. Use process substitution &>file abcdefghijklmnopqrst or for loops in preference to piping to while. Finally, 5. | (pipe) serves as a command chaining tool. [[ ... ]] is preferred over [ and test. and (maybe zero paded or with an increment rate) Here document is a section of a source code file that integers, assuming the Bash version is 4 or newer: Naming conventions. Function and variable names is treated as if it were a separate file: should be lower case, with underscore to separate echo{01..10..1}. cat <<EOF > /path/to/your/file words. Constants and environment variable names 01. 02. 03. 04. 05. 06. 07. 08. 09. 10. Line to be written in your file. should be all caps, declared at the top of the file. Use 2.4.2 Tilde expansion EOF readonly or declare -r to ensure they’re read only. Declare function specific variables with ere is a tilde expansion as well. e expression Using 'EOF' instead prevents variable expansion. local. A function called main is required for scripts ~[user] expands to the home directory of the 2.6 Control flow statements long enough to contain at least one other function. current (or given) user. e one-line constructs and work not like and, 2.4.3 Parameter expansion && || Other useful resources If you want to understand or (^, _), but the if – then – else statement. Nonzero Bash better, consider one of the following webpages: 1. ${var^}, ${var,}, ${var~} convert first exit status denotes (usually) a failure. 1. character to upper, lower or reverse case http://wiki.bash-hackers.org 2.6.1 Loops 2. http://mywiki.wooledge.org/BashGuide (every, when caret/comma/tilde are doubled). while read myline; do Avoid guides by TLDP!!! is has an impact on every array element. echo "It says ${myline}" 2. , remove ${var#pattern} ${var%pattern} done < some_file 2 Programming in Bash the pattern from the beginning, end of variable (greedy when hash, percent sign are 2.1 Shebang for var in "the first" "the second"; do doubled). Application: extracting parts of a e shebang ( ) at the head of a script indicates an echo "${var}" #! filename. interpreter for execution, as in #!/bin/bash. Lines done starting with a # (with the exception of shebang) are 3. ${var/pattern/string} performs a single for((i=1; i <= 10; i++ )); do comments and thus won’t be executed. Even better (when first slash is doubled: full) search and echo "i = ${i}." is #!/usr/bin/env bash (overflow-16365130). replace operation. done # C-style 1 2.6.2 Conditionals compopt: . ???? See also ack, an optimized for programmers tool Here at least one statement must be specified inside continue: . ???? like grep, at https://beyondgrep.com/ or learn every block, but one can use a single colon (:) as a declare: . ???? Perl. null statement to avoid rewriting the code. dirs: . .???? 4.1 grep – pattern search enginge disown: . ???? if condition; then echo: displays a line of text: e ed command g/re/p was used to globally commands e enables interpretation of backslash escapes, search a regular expression and print. does not output the trailing newline. elif second_condition; then n ??? grep prints lines matching a pattern: some_commands enable: . ???? E interprets pattern as an extended regexp, else eval: . .???? F does not recognize regexps, other_commands exec: . ???? P interprets pattern as a Perl regexp, fi exit: . .???? export: . ???? c prints a count of matching lines instead, select word in "Bash" "Haskell" "Python" false: . ???? m exits ater finding ... matches, do fc: ....................................???? o prints only matched parts of lines, echo "Your language is $word". fg: . ???? n prints line numbers as well, done getopts: . ???? r reads all files under each directory. hash: . ???? ere is also a case instruction: help: . ???? uses a “regexp” pattern, history: . .???? e case $language in obtains patterns from a file, jobs: . ???? f bash) ignores case disctinctions, kill: . ???? i echo "Bourne Again Shell!" inverts the sense of matching, let: . ???? v ;; selects only lines with whole words matches, local: . ???? w python|haskell) x selects matches exactly matching whole line. echo "Python or Haskell!" logout: . ???? mapfile: . ???? ;; prints ... lines of trailing content, popd: . .???? A *) prints ... lines of leading content, printf: . ???? B echo "Unknown language!" C prints ... lines of both contents. ;; # optional pushd: . ???? esac pwd: prints name of current directory. 4.2 sed – stream editor read: . ???? ??? sed filters and transforms text: 2.6.3 Single versus double square brackets readarray: . ???? -e adds a script to the commands to be executed, e [ command is defined by POSIX, ] prevents its readonly: . ???? -i edits files in place. With sufix supplied, further arguments from being used. Double return: . ???? makes backup (sed -i[suffix] ...), brackets, the [[ command, are a Bash extension set: . .???? -n suppresses auto- printing of pattern space, that changes the way text ist being parsed: shit: .
Load more

Recommended publications
  • 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]
  • 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.
    [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]