Source code

Organization

Most programs do not contain all the resources needed to run them and rely on external libraries. Part of the compiler's function is to link these files in such a way that the program can be executed by the hardware.

Software developers often use configuration management to track changes to source code files (version control). The configuration management system also keeps track of which object code file corresponds to which version of the source code file.

Purposes

Estimation

The number of source lines of code (SLOC) is often used as a metric when evaluating the productivity of computer programmers, the economic value of a code base, effort estimation for projects in development, and the ongoing cost of software maintenance after release.

Communication

Source code is also used to communicate algorithms between parties, e.g., code snippets online or in books.

Computer programmers can find it helpful to review extant source code to learn about programming techniques. The sharing of source code between developers is often cited as a contributing factor to the maturing of their programming skills. Some consider source code an expressive artistic medium.

Source code often contains comments—blocks of text marked for the compiler to ignore. This content is not part of the program logic, but is instead intended to help readers understand the program.

Companies often keep the source code confidential in order to hide algorithms considered a trade secret. Proprietary, secret source code and algorithms are widely used for sensitive government applications such as criminal justice, which results in black box behavior with a lack of transparency into the algorithm's methodology. The result is avoidance of public scrutiny of issues such as bias.

Modification

Access to the source code (not just the object code) is essential to modifying it. Understanding extant code is necessary to understand how it works and before modifying it. The rate of understanding depends both on the code base as well as the skill of the programmer. Experienced programmers have an easier time understanding what the code does at a high level. Software visualization is sometimes used to speed up this process.

Many software programmers use an integrated development environment (IDE) to improve their productivity. IDEs typically have several features built in, including a source-code editor that can alert the programmer to common errors. Modification often includes code refactoring (improving structure without changing function) and restructuring (improving structure and function simultaneously). Nearly every change to code introduces new bugs or unexpected ripple effects, which require another round of fixes.

Code reviews by other developers are often used to scrutinize new code added to a project. The purpose of this phase is often to verify that the code meets style and maintainability standards and that it is a correct implementation of the software design. According to some estimates, code review dramatically reduce the number of bugs persisting after software testing is complete. Along with software testing that works by executing the code, static program analysis uses automated tools to detect problems with the source code. Many IDEs support code analysis tools, which might provide metrics on the clarity and maintainability of the code. Debuggers are tools that often enable programmers to step through execution while keeping track of which source code corresponds to each change of state.

Compilation and execution

Source code files in a high-level programming language must go through a stage of preprocessing into machine code before the instructions can be carried out. After being compiled, the program can be saved as an object file and the loader (part of the operating system) can take this saved file and execute it as a process on the computer hardware. Some programming languages use an interpreter instead of a compiler. An interpreter converts the program into machine code at run time, which makes them 10 to 100 times slower than compiled programming languages.

Portability

Another reason many programs are distributed in source code form, instead of as executable binary files, is that (often) a single source code file can be written once and will run on a variety of different end-user machines (each with their own localized compiler or interpreter), unlike an executable code file which generally only works on nearly-identical machines. Source code was used this way to distribute the Unix operating system early in the history of Unix, and later to allow programs written in scripting languages (in particular the JavaScript client-side scripting language) to run on a wide variety of machines.

For this goal, minified, obfuscated, or decompiled source code files (all of which eliminate the comments in the original code) are generally just as portable as the original source code files (which nearly always include comments), even though they are far less useful for modification, and therefore don't meet the definition of source code in the GNU General Public License, version 2 (GPL2).

Quality

Software quality is an overarching term that can refer to a code's correct and efficient behavior, its reusability and portability, or the ease of modification. It is usually more cost-effective to build quality into a product from the start rather than try to add it later in a development process. Higher quality code reduces lifetime cost to both suppliers and customers as via higher reliability and maintainability.

Maintainability is the quality of software enabling it to be easily modified without breaking extant functions. Following coding conventions such as using clear function and variable names that correspond to their purpose makes maintenance easier. Use of conditional loop statements only if the code could execute more than once, and eliminating code that will never execute can also increase understandability. Many software development organizations neglect maintainability during the development phase, even though it will increase long-term costs. Technical debt is incurred when programmers, often out of laziness or urgency to meet a deadline, choose quick and dirty solutions rather than build maintainability into their code. A common cause is underestimates in software development effort estimation, leading to insufficient resources allocated to development. A challenge with maintainability is that many software engineering courses do not emphasize it. Development engineers who know that they will not be responsible for maintaining the software do not have an incentive to build in maintainability.

Copyright and licensing

The situation varies worldwide, but in the United States before 1974, software and its source code was not copyrightable and therefore always public domain software. In 1974, the US Commission on New Technological Uses of Copyrighted Works (CONTU) decided that "computer programs, to the extent that they embody an author's original creation, are proper subject matter of copyright".

Proprietary software is rarely distributed as source code. Although the term open-source software literally refers to public access to the source code, open-source software has additional requirements: free redistribution, permission to modify the source code and release derivative works under the same license, and nondiscrimination between different uses—including commercial use. The free reusability of open-source software can speed up development.

Source file

Source files are the files used to create a final work.

Software

In the context of software development, a source file is a human readable file containing source code written in a programming language. The source file must be processed by a compiler to create a format that can be directly executed or an intermediate form that can be interpreted at runtime.

Documents

Source files for documents include word processor formats (ODT, DOCX), presentation formats (PPTX, ODP), or markup languages (Markdown, LaTeX), from which a final format such as Portable Document Format (PDF) is derived for consistent display and distribution across different systems. In digital preservation, retaining source files alongside final-state files is a recommended practice.

Hardware

In hardware design, source files include CAD files for mechanical components and schematics or PCB layout files for electronic components. From these editable source files, manufacturing outputs such as STL files for 3D printing or Gerber files for circuit board fabrication are created.

With CAD modelers, hardware's design can be created through direct modeling, where geometry is manipulated directly, or parametric design where shapes are based on equation or constraints. From these source files, tessellation can be applied to translate curved surfaces into a mesh of triangles, suitable for various applications such as 3D printing via STL files or real-time rendering in game engines.

Image

In graphic design, source files such as SVG or PSD preserve layers that can be independently manipulated using graphics software. From these source files, compressed distribution formats such as PNG or JPEG are derived. In professional practice, ownership of source files may be subject to dispute — designers typically retain them as intellectual property unless contractual terms specify otherwise.

Fonts

In typography, font source files such as UFO, VFC or .glyphs contain human-readable glyph outlines manipulated using a font editor, from which font binary files such as OTF, TTF, or WOFF are generated. These binary files are then used by applications such as word processors to render and format text.