Update README.md

check-smart-devices.ps1

Data/Abbr/aviation.csv

@@ -1,4 +1,6 @@
 Abbr,Term
+3P,"Perceive, Process, Perform"
+5P,"Plan, Plane, Pilot, Passengers, Programming"
 A/A,Air to air TACAN function
 A/C,Aircraft
 A/D,Aerodrome
@@ -52,6 +54,7 @@ ADS,Automated Distribution System
 ADS,Automatic Dependent Surveillance
 ADS-B,Automatic Dependent Surveillance-Broadcast
 AENA,Aeropuertos Españoles y Navegación Aérea
+AEO,All Engines Operative
 AERA,Automated En-Route Air Traffic Control
 AEW,Airborne Early Warning
 AF,Air Field
@@ -194,8 +197,10 @@ CW,Continous Wave
 CW,Cold Weather
 CWS,Collision Warning System
 CWP,Controller Working Position
+DA,Density Altitude
 DAS,DFS Aviation Services (DFS subcompany for services outside Germany)
 DCIA,Dependent Converging Instrument Approach
+DECIDE,"Detect, Estimate, Choose, Identify, Do, and Evaluate"
 DEL,Delivery
 DFS,Deutsche Flugsicherung (ATC in Germany)
 DGAC,Direction générale de l'aviation civile
@@ -207,6 +212,7 @@ ECAC,European Civil Aviation Conference
 ELEV,Field Elevation
 EFM,Gesellschaft für Enteisen und Flugzeugschleppen
 ETA,Estimated Time of Arrival
+ETL,Effective Translational Lift (for helicopters)
 ETOPS,Extended-range Twin-engine Operational Performance Standards
 ETVS,Electronic Terminal Voice Switch
 FAA,U.S. Federal Aviation Administration
@@ -243,6 +249,7 @@ GP,Glide Path
 GPS,Global Positioning System
 GS,Ground Speed or Glideslope
 HKIA,Hong Kong International Airport
+HOTS,Higher-Order Thinking Skills
 IAA,Israeli Airport Authority
 IAF,Israeli Air Force
 IANS,Institute of Air Navigation Services, a division of Eurocontrol
@@ -250,8 +257,10 @@ IAS,Indicated Air Speed
 IATA,International Air Transport Association, HQ in Montreal, Canada
 IFR,Instrument Flight Rules
 IG,Image Generator
+IGE,In Ground Effect
 IGLR,Integrated Ground Lighting and Radar
 ILS,Instrument Landing System
+ISA,International Standard Atmosphere
 IMC,Instrument Meteorological Conditions
 KAT,Kaufbeuren ATM Training (DFS subcompany)
 LAA,Lappland Aviation Academy
@@ -265,14 +274,19 @@ LVP,Low Visibility Procedures
 MATS,Malta Air Traffic Services
 MEA,Minimum En-route Altitude
 METAR,Meteorological Aerodrome Report
+MCP,Maximum Continuous Power
 MLW,Maximum Landing Weight
 MSL,Median Sea Level
 MSTA,Minimum Safe Turning Altitude
 MTOW,Maximum Take-Off Weight
 NLFS,Night Low Flying System
 OCTA,Outside Control Areas
+OEI,One Engine Inoperative
+OGE,Out of Ground Effect
 OFZ,Obstacle Free Zone
 OJT,On the Job Training
+OODA,"Observation, Orientation, Decision, and Action"
+PA,Pressure Altitude
 PAPI,Precision Approach Path Indicator
 PAR,Precision Approach Radar
 PIC,Pilot in Command
@@ -301,11 +315,13 @@ RCS,Radar Cross Section
 RET,Rapid Exit Taxiways
 RF,Radio Frequency
 RFFS,Rescue and Fire Fighting Services
+RFM,Rotorcraft Flight Manual
 RIMCAS,Runway Incursion Monitoring and Conflict Alert System
 RJAF,Royal Jordanian Air Force
 RJC,Reject
 RPI,Runway Point of Intercept
 RPM,Rotations per Minute
+ROFZ,Runway Obstacle Free Zone
 RMI,Radio Magnetic Indicator
 RNAV,Area Navigation
 RNP,Required Navigation Performance
@@ -342,7 +358,8 @@ SIF,Selective Identification Friend or Foe
 SIGMET,Significant Meteorological (Information) Report
 SILs,Sector Inbound Lists
 SIM,Simulator
-SKYGUIDE,Swiss Air Traffic Control
+SKYGUIDE,Air Traffic Control of Switzerland
+SL,Sea Level
 SLB,Side lobe Blanking
 SLC,Side lobe Cancellation
 SLOC,Slovenia Control
@@ -378,7 +395,7 @@ TAIS,Tactical Air Intelligence System
 TAP,Target Acquisition Protocol
 TARMAC,Taxi and Ramp Management and Control
 TAS,Terminal Airspace System
-TAS,True Airspeed
+TAS,True Air Speed
 TAWS,Terrain Awareness and Warning System
 TCAS,Traffic alert and Collision Avoidance System
 TCDS,Type Certificate Data Sheet
@@ -400,6 +417,7 @@ TM,Traffic Management
 TMA,Terminal Control Area
 TOC,Top Of Climb
 TOD,Top Of Descent
+TOP,Take-Off Power
 TOR,Terms Of Reference
 TOR,Tornado aircraft
 TOWSIM,Tower Simulator
@@ -419,6 +437,7 @@ UAT,Universal Access Transceiver
 UAV,Unmanned Aerial Vehicle
 UDF,Ultra High Frequency Direction Finding
 UEI,"Units, Equipment, Installations"
+UFA,"UFA, Inc., the world's premier developer of Air Traffic Control simulation systems"
 UHF,Ultra High Frequency
 UIR,Upper Flight Information Region
 UKCAA,United Kingdom Civil Aviation Authority
@@ -444,7 +463,7 @@ VLF,Very Low Frequency
 VMC,Visual Meteorological Conditions
 VMO,maximum operation speed is the air speed than should never be exceeded deliberately in normal operation, whatever the flight situation isVOR,VHF Omni-directional Range
 VOLMET,Meteorological Information for Aircraft in Flight
-VOR,VHF Omni-directional Radio Range
+VOR,VHF Omni-directional Receiver
 VORTAC,VOR -TACAN combination
 VREF,1.3 times the stalling speed of the aircraft in the stated landing configuration and at the prevailing aircraft weight
 VRR,Voice Recognition and Response
@@ -458,6 +477,9 @@ VTC,Virtual Training Centre
 VTOL,Vertical Take-Off and Landing
 VTOSL,Vertical Take-Off and Short Landing
 VTS,Vehicle Tracking System
+Vtoss,Take-off safety speed
+Vy,Optimimum climbing speed
+Vz,Rate-of-climb
 WA,Wind Angle
 WAAS,Wide Area Augmentation System
 WAM,Wide Area Multilateration

Data/Abbr/computing.csv

@@ -1071,7 +1071,7 @@ ESMR,Enhanced Specialized Mobile Radio
 ESMTP,Extended Simple Mail Transfer Protocol
 ESP,event stream processing
 ESS,employee self-service
-ETL,extract, transform, load
+ETL,"extract, transform, load"
 ETM,Enterprise Transportation Management
 ETO,Engineer To Order
 ETP,Enterprise Transportation Planning
@@ -1092,7 +1092,6 @@ ExRCA,Exchange Remote Connectivity Analyzer
 EZ/EC,Empowerment Zone/Enterprise Community
 FA,Flexible Automation
 FACTA,Fair and Accurate Credit Transactions Act
-FAQ,frequently-asked questions
 FAR,Federal Acquisition Regulation
 FAS,Final Assembly Schedule
 FASAB,Federal Accounting Standards Advisory Board
@@ -1195,7 +1194,7 @@ FPS,First-Person Shooter
 fps,Frames Per Second
 FPT,Fine Pitch Technology
 FPU,Floating-Point Unit
-FQA,frequently questioned answers
+FQA,Frequently Questioned Answers
 FQDN,Fully Qualified Domain Name
 FR,Frame Relay
 FRA,Federal Railroad Administration

Data/Abbr/general.csv

@@ -167,7 +167,7 @@ ADSR,"Attack,Decay,Sustain,Release (sound envelope specification)"
 ADT,Atlantic Daylight Time (UTC−3 hours)
 ADTB,Army Doctrine and Training Bulletin
 ADW,Air Defence Warning
-AE,"Armed Forces Africa/Canada/Europe/Middle East (postal symbol),United Arab Emirates (ISO 3166 digram; FIPS 10-4 country code),Artix Entertainment,American Eagle,A&E,(a/i) Arts & Entertainment Network,the original name for the U.S. TV channel now known as A&E Network"
+AE,"Armed Forces Africa/Canada/Europe/Middle East (postal symbol),United Arab Emirates (ISO 3166 digram; FIPS 10-4 country code),Artix Entertainment,American Eagle,A&E, Arts & Entertainment Network,the original name for the U.S. TV channel now known as A&E Network"
 ae,Avestan language (ISO 639-1 code)
 AED,United Arab Emirates dirham (ISO 4217 currency code)
 AEDT,Australian Eastern Daylight Time
@@ -221,7 +221,7 @@ AFWA,Air Force Weather Agency,Association of Fish and Wildlife Agencies,AG[edit]
 AG,air gunner,Aktiengesellschaft (German,"incorporated"),Algeria (FIPS 10-4 country code),Antigua and Barbuda (ISO 3166 digram),Assemblies of God
 ag,Attogram
 Ag,Silver (Latin argentum)
-AGA-(a/i) AB Gas-accumulator ("ah-gah",Swedish company),Advanced Graphics Architecture
+AGA- AB Gas-accumulator ("ah-gah",Swedish company),Advanced Graphics Architecture
 AGARD,Advisory Group for Aerospace Research and Development
 AGARDograph,Advanced Guidance for Alliance Research and Development publication
 AGASA,Akeno Giant Air Shower Array (cosmic ray detector)
@@ -263,7 +263,7 @@ AIMP,Aurora Incremental Modernization Project
 AIPAC,American Israel Public Affairs Committee
 AIR,Aircraft Inventory Record
 AIRFA,American Indian Religious Freedom Act
-AIRS,(a/i) Aerometric Information Retrieval System (obsolete; replaced with AFS)
+AIRS, Aerometric Information Retrieval System (obsolete; replaced with AFS)
 AIS,Australian Institute of Sport,Automatic Identification System
 AISB,(British Society for the Study of) Artificial Intelligence and the Simulation of Behaviour
 aJ,Attojoule
@@ -385,7 +385,7 @@ Ar,Argon
 ara,Arabic language (ISO 639-2 code)
 ARAG,Advanced Research and Assessment Group
 ARB,Administrative Review Board
-ARBA,(a/i) Army Review Boards Agency
+ARBA, Army Review Boards Agency
 ARC,Arc-second Raster Chart,Appalachian Regional Commission
 ARCA,Automobile Racing Club of America
 ARCENT,United States Army Central Command
@@ -440,7 +440,7 @@ ASMB,American Society for Matrix Biology,Adult Swim Message Board
 ASME,American Society of Mechanical Engineers,American Society of Magazine ors
 ASMP,Air-Sol Moyenne Portée missile (French "Medium-range air to surface"),Asymmetric multiprocessing
 ASN,Associate of Science in Nursing
-ASOC,(a/i) Air Sovereignty Operations Centre,Air Support Operations Centre,Airport Security and Operations Centre,Antarctic and Southern Ocean Coalition,Atlanta Symphony Orchestra Chorus,Australian Standard Offence Classification
+ASOC, Air Sovereignty Operations Centre,Air Support Operations Centre,Airport Security and Operations Centre,Antarctic and Southern Ocean Coalition,Atlanta Symphony Orchestra Chorus,Australian Standard Offence Classification
 ASP,Active Server Pages,American Society of Primatologists,Ammunition Supply Point,Application Service Provider (cf internet service provider),Astronomical Society of the Pacific,Association of Surfing Professionals
 ASPI,Australian Strategic Policy Institute
 ASR,Alkali-silica reaction,Anti Slip Regulation
@@ -539,7 +539,7 @@ AZE,Azerbaijan (ISO 3166 trigram)
 aze,Azerbaijani language (ISO 639-2 code)
 AZN,Azerbaijani manat (ISO 4217 currency code)
 AZUR,"Actions en zone urbaine (French for: Urban Operations)"
-BAR,"Barbados (IOC trigram,but not FIFA or ISO 3166),British American Racing,Browning Automatic Rifle,Buy-American Restrictions,BARD , Binational Agricultural Research and Development fund (between the US and Israel),BARDA , Biomedical Advanced Research and Development Agency,BART , Bay Area Rapid Transit,BAS , Battalion Aid Station,BASE , Building,Antenna,Span,Earth (parachute from),BASF , Badische Anilin und Soda Fabrik (Baden Aniline and Soda Factory,a German chemicals company),BASIC , Beginner's All-purpose Symbolic Instruction Code (acronym was added later,originally it was simply Basic),BAT ,(a/i) Basic Aid Training,BATF , U.S. Bureau of Alcohol,Tobacco,and Firearms,BATS , Behavior Analysis Training System ,Bradley Advanced Training System,BATTeRS , Bisei Asteroid Tracking Telescope for Rapid Survey,BB[edit]"
+BAR,"Barbados (IOC trigram,but not FIFA or ISO 3166),British American Racing,Browning Automatic Rifle,Buy-American Restrictions,BARD , Binational Agricultural Research and Development fund (between the US and Israel),BARDA , Biomedical Advanced Research and Development Agency,BART , Bay Area Rapid Transit,BAS , Battalion Aid Station,BASE , Building,Antenna,Span,Earth (parachute from),BASF , Badische Anilin und Soda Fabrik (Baden Aniline and Soda Factory,a German chemicals company),BASIC , Beginner's All-purpose Symbolic Instruction Code (acronym was added later,originally it was simply Basic),BAT , Basic Aid Training,BATF , U.S. Bureau of Alcohol,Tobacco,and Firearms,BATS , Behavior Analysis Training System ,Bradley Advanced Training System,BATTeRS , Bisei Asteroid Tracking Telescope for Rapid Survey,BB[edit]"
 BB,"Barbados (ISO 3166 digram; FIPS 10-4 country code),Boys' Brigade (Christian youth organization),Brigitte Bardot (actress),Bumblebee"
 BBB,"Better Business Bureau,Blood-brain barrier"
 BBC,"Breeding Bird Census,British Broadcasting Corporation,Bumper to Back of Cab (trucking measurement)"
@@ -1119,7 +1119,7 @@ DE,Delaware (postal symbol),Germany (ISO 3166 digram)
 de,German language (ISO 639-1 code)
 DEA,Drug Enforcement Administration
 DEA,Drug Enforcement Agency
-DEC,(a/i) Department of Environmental Conservation,Digital Equipment Corporation,Disasters Emergency Committee
+DEC, Department of Environmental Conservation,Digital Equipment Corporation,Disasters Emergency Committee
 DeCA,(U.S.) Defense Commissary Agency
 DEFCON,Defence readiness condition
 DEFRA,(UK) Department for Environment,Food and Rural Affairs
@@ -1438,7 +1438,7 @@ EKG,Electrocardiogram (from German Elektrokardiogramm)
 EKMS,Electronic Key Management System
 EL,Exalitre
 el,Greek language (ISO 639-1 code)
-ELF-(a/i) Earth Liberation Front,Endangered Language Fund,Eritrean Liberation Front,Executable and Linkable Format,Extremely Low Frequency
+ELF- Earth Liberation Front,Endangered Language Fund,Eritrean Liberation Front,Executable and Linkable Format,Extremely Low Frequency
 ELINT,Electronic Intelligence
 ELL,English Language Learner
 ell,Greek language (ISO 639-2 code)
@@ -1480,10 +1480,10 @@ eo,Esperanto language (ISO 639-1 code)
 EOD,Explosive Ordnance Disposal
 EOG,ElectroOculoGraphy
 EOM,End of Message
-EOS,Earth Observation Satellite,(a/i) Electro-Optical System,Canon's autofocusing system for film and digital SLR cameras,Electrophoresis Operations in Space,a space manufacturing project of the McDonnell Douglas Astronautics Company
+EOS,Earth Observation Satellite, Electro-Optical System,Canon's autofocusing system for film and digital SLR cameras,Electrophoresis Operations in Space,a space manufacturing project of the McDonnell Douglas Astronautics Company
 EOSAT,Earth Observation Satellite
-EOSDIS,(a/i) Earth Observation Satellite Data and Information System
+EOSDIS, Earth Observation Satellite Data and Information System
-EOTS,Electro-Optical Tactical Sensor,(a/i) Eye Of The Storm (World of Warcraft)
+EOTS,Electro-Optical Tactical Sensor, Eye Of The Storm (World of Warcraft)
 EP,European Parliament
 EP,Extended play
 EPA,EicosaPentaenoic Acid,Environmental Protection Agency
@@ -1491,7 +1491,7 @@ EPCOT,Experimental Prototype Community Of Tomorrow
 EPCR,Endothelial protein C receptor,European Professional Club Rugby
 EPFL,École polytechnique fédérale de Lausanne (French,"Lausanne Federal Institute of Technology")
 EPGS,EOS Polar Ground Sites
-EPIRB,(a/i) Emergency Position Indicating Radio Beacon
+EPIRB, Emergency Position Indicating Radio Beacon
 EPL,English Premier League
 EPLRS,Enhanced Position Location Reporting System ("ee-plarz")
 EPO,Ellinikí Podosferikí Omospondía (Greek Ελληνική Ποδοσφαιρική Ομοσπονδία,translated as "Hellenic Football Federation"),European Patent Organisation or its main organ,the European Patent Office,Erythropoietin
@@ -1505,7 +1505,7 @@ EQG,Equatorial Guinea (FIFA trigram,but not IOC or ISO 3166)
 ER,Emergency Room,Eritrea (ISO 3166 digram; FIPS 10-4 country code)
 Er,Erbium
 ERA,Earned run average,Engineering Research Associates,Equal Rights Amendment,English Racing Automobiles,European Railway Agency
-ERCIM,(a/i) European Research Consortium for Informatics and Mathematics
+ERCIM, European Research Consortium for Informatics and Mathematics
 ERI,Eritrea (ISO 3166 trigram)
 ERLAWS,Eastern Ruapehu Lahar Alarm and Warning System
 ERN,Eritrean nakfa (ISO 4217 currency code)
@@ -1576,7 +1576,7 @@ FAADEZ,Forward Area Air Defence Engagement Zone
 FAAFP,Fellow of the American Academy of Family Physicians
 FAAN,Fellow of the American Academy of Neurology
 FAAN,Fellow of the American Academy of Nursing
-FAAQ,(a/i) Frequently Asked and Anticipated Questions (cf. FAQ)
+FAAQ,Frequently Asked and Anticipated Questions
 FAASV,Field Artillery Ammunition Supply Vehicle
 FAB,Feline Advisory Bureau (UK feline charity)
 FAC,Forward Air Controller,Front of Allies for Change,Frontal Affinity Chromatography,Full Aperture Calibrator
@@ -1594,14 +1594,14 @@ fao,Faroese language (ISO 639-2 code)
 FAO,Food and Agriculture Organization
 FAPA,Fellow of the American Psychological Association
 FAPHA,Fellow of the American Public Health Association
-FAQ,(a/i) Frequently Asked Questions (sometimes pronounced "fak")
+FAQ,Frequently Asked Questions (sometimes pronounced "fak")
 FARC,Fuerzas Armadas Revolucionarias de Colombia (Spanish,"Revolutionary Armed Forces of Colombia")
 FARP,Forward Arming and Refuelling Point / Forward Area Rearm/refuel Point
 FAS,Federation of American Scientists,Fetal Alcohol Syndrome
 fas,Persian language (ISO 639-2 code)
 FASCAM,Family of Scatterable Mines[1]
 FASD,Fetal Alcohol Spectrum Disorder
-FASEB,(a/i) Federation of American Societies for Experimental Biology
+FASEB,Federation of American Societies for Experimental Biology
 FAT,Field Artillery Tractor
 FAVS,Future Armoured Vehicle System
 FAW,Football Association of Wales
@@ -1629,24 +1629,24 @@ FDR,Flight Data Recorder,Franklin Delano Roosevelt
 FE,Fully Exposed (armoured vehicle target,as opposed to Hull-Down)
 Fe,Iron (Latin Ferrum)
 FEAR,First Encounter Assault Recon,False Evidence Appears Real
-FEAST,(a/i) Forum for European-Australian Science and Technology Cooperation
+FEAST,Forum for European-Australian Science and Technology Cooperation
 FEATS,Festival of European Anglophone Theatrical Societies link title
 FEB,Federación Española de Baloncesto (Spanish,"Spanish Basketball Federation"),Federatie Eredivisie Basketball (Dutch,"Federation Honorary Division (of) Basketball"),the former name of the basketball competition now known in Dutch by the English-language Dutch Basketball League,Força Expedicionária Brasileira (Portuguese,"Brazilian Expeditionary Force")
 FEBA,Forward Edge of the Battle Area
-FED,(a/i) Field emission display
+FED,Field Emission Display
 FEDEP,Federation Development Process (Simulation)
 FEF,Frontal Eye Field (neurophysiology)
 FEI,Fédération équestre internationale (French,"International Federation for Equestrian Sports")
-FEMA-(a/i) Farm Equipment Manufacturers Association,(a/i) U.S. Federal Emergency Management Agency,Fire Equipment Manufacturers' Association
+FEMA,"Farm Equipment Manufacturers Association, U.S. Federal Emergency Management Agency,Fire Equipment Manufacturers' Association"
 FEMEXFUT,Federación Mexicana de Fútbol Asociación (Spanish,"Mexican Association Football Federation")
 FENAFUTH,Federación Nacional Autónoma de Fútbol de Honduras (Spanish,"National Autonomous Football Federation of Honduras")
-FENS,(a/i) Federation of European Neuroscience Societies
+FENS,Federation of European Neuroscience Societies
 FEP,Firepower Enhancement Program,Fleet satellite (FLTSAT) Extremely high frequency (EHF) Package
 FEPAFUT,Federación Panameña de Fútbol (Spanish,"Panamanian Football Federation")
 FES,Flywheel Energy Storage
 FEST,Frankfurt English Speaking Theatre link title
 FET,Field-effect transistor
-FEZ,(a/i) Fighter Engagement Zone
+FEZ,Fighter Engagement Zone
 fF,Femtofarad
 FF,Final Fantasy
 ff,Fula language (ISO 639-1 code)
@@ -1691,7 +1691,7 @@ fin,Finnish language (ISO 639-2 code)
 FINA,(p/a) Fédération internationale de natation (French,"International Swimming Federation")
 FIR,Final Inspection Report,Federazione Italiana Rugby (Italian,"Italian Rugby (Union) Federation")
 FIRES,Fever Induced Refractory Epilepsy Syndrome or Febrile Infection-Related Epilepsy Syndrome
-FIS,(a/i) Fédération internationale de ski (French "International Ski Federation")
+FIS,"Fédération internationale de ski (French for: International Ski Federation)"
 FISA,Fédération Internationale des Sociétés d'Aviron (French,"International Federation of Rowing Associations")
 FISH,Fluorescence In-Situ Hybridisation
 FiST,Fire Support Team
@@ -1713,16 +1713,16 @@ FL,Florida (postal symbol)
 fl,floruit (Latin,"living") (genealogy)
 FLA,Florida,Front Line Assembly,Future Large Aircraft
 FLAB,Four-letter abbreviation
-FLAC,(a/i) Free Legal Advice Centres
+FLAC,Free Legal Advice Centres
-FLAC,(a/i) Free Lossless Audio Codec
+FLAC,Free Lossless Audio Codec
 FLAK,FLugAbwehrKanone (German for "Anti-Aircraft Guns")
 FLB,Forward Logistics Base
-FLET,(a/i) Forward Line of Enemy Troops
+FLET,Forward Line of Enemy Troops
 FLG,Falun Gong
 FLIP,Flight Information Publication
 FLIR,Forward Looking InfraRed (sensor)
 FLK,Falkland Islands (ISO 3166 trigram)
-FLOT,(a/i) Forward Line of Own Troops
+FLOT,Forward Line of Own Troops
 FLQ,Free Legal Questions
 FLQ,Front de libération du Québec (French for "Québec Liberation Front")
 FLSA,Fair Labor Standards Act
@@ -1813,7 +1813,7 @@ FTE,Full Time Equivalent
 FTL,Faster Than Light
 FTS,Flight Termination System used during some rocket launches
 FTS,Fuck That Shit
-FTSE,(a/i) Financial Times Stock Exchange ("footsie")
+FTSE,Financial Times Stock Exchange ("footsie")
 FTW,For The Win (a commonly used phrase used online to indicate success) F@#K The World,Forever Together Where ever (gang slogan)
 FU,Smoke (METAR Code)
 FUBAR,Fucked/Fouled Up Beyond All Recognition/Repair
@@ -1928,7 +1928,7 @@ GIN,Guinea (ISO 3166 trigram),Guidelines International Network
 GINK,Going Insane Not Knowing,orig. Colorado 2010 M.Kalfas
 GINO,Godzilla In Name Only
 GIP,Gibraltar pound (ISO 4217 currency code)
-GISS,(a/i) General Impression of Size and Shape,Goddard Institute for Space Studies
+GISS,"General Impression of Size and Shape,Goddard Institute for Space Studies"
 GJ,Gigajoule,Grenada (FIPS 10-4 country code),Gujarat (Indian state code)
 GJD,Geocentric Julian Day
 GK,Gigakelvin,Guernsey (FIPS 10-4 territory code)
@@ -2016,7 +2016,7 @@ GSG,German Sport Guns,Global Scenario Group (former environmental research organ
 GSGB,(God send glamour boy 9-10/10)
 GSK,GlaxoSmithKline [good sexual karma]
 GSM,General Service Medal,Grams per Square Metre (paper thickness; properly g/m2),Ground Station Module,Groupe spécial mobile (French,"Special Mobile Group"; official expansion is now Global System for Mobile Communications)
-GSN,(a/i) Game Show Network
+GSN,Game Show Network
 GSO,General Services Officer (U.S. Department of State)
 GSOH,Good Sense Of Humour
 GSP,Georges St-Pierre (Canadian MMA fighter)
@@ -2106,7 +2106,7 @@ HEMP,High-Altitude Electromagnetic Pulse
 HEO,High Earth Orbit,Highly Elliptical Orbit
 HEOSS,High Earth Orbit Space Surveillance
 HEP,High-Explosive Plastic (ammunition)
-HEPA,(a/i) High-Efficiency Particulate Air (filter)
+HEPA,High-Efficiency Particulate Air (filter)
 her,Herero language (ISO 639-2 code)
 HESH,High-Explosive,Squash-Head (ammunition)
 HESV,Heavy Engineering Support Vehicle
@@ -2271,7 +2271,7 @@ IANAL,I Am Not A Lawyer
 IAQ,Indoor air quality,Infrequently Asked Questions
 IAS,Image Assessment System
 IASIP,It's Always Sunny in Philadelphia
-IATA,(a/i) International Air Transport Association
+IATA,International Air Transport Association
 IATF,International Automotive Task Force
 IATSE,International Alliance of Theatrical Stage Employees
 IAU,International Association of Universities,International Astronomical Union
@@ -2295,7 +2295,7 @@ ICBN,International Code of Botanical Nomenclature
 ICC,Integrated Command and Control,International Criminal Court,International Cricket Council,Interstate Commerce Commission,International Chamber of Commerce
 ICD,Implantable Cardioverter-Defibrillator,Initial Capabilities Document,International Classification of Diseases
 ICE,In case of emergency
-ICES,(a/i) International Council for the Exploration of the Sea
+ICES,International Council for the Exploration of the Sea
 ICF,Intelligent Community Forum
 ICHTHYS,Iesous Christos,Theou Yios,Soter (Greek,"Jesus Christ,Son of God,Savior")
 ICM,Improved Conventional Munition,Integrated Collection Management,International Congress of Mathematicians,Iraq Campaign Medal
@@ -2304,7 +2304,7 @@ ICNAF,International Commission for the Northwest Atlantic Fisheries (became NAFO
 ICNI,Integrated Communication,Navigation,and Identification
 ICO,Intermediate Circular Orbit
 ICP,Inductively coupled plasma,Insane Clown Posse
-ICPE,(a/i) International Conference on Pharmacoepidemiology,the annual conference of the International Society for Pharmacoepidemiology
+ICPE,"International Conference on Pharmacoepidemiology,the annual conference of the International Society for Pharmacoepidemiology"
 ICRAF,International Centre for Research in Agroforestry (a.k.a. World Agroforestry Centre since 2002)
 ICRISAT,International Crops Research Institute for the Semi-Arid Tropics
 ICRL,Individual Component Repair List
@@ -2429,7 +2429,7 @@ INFOSEC,Information Security
 INLA,Irish National Liberation Army
 INMARSAT,International Maritime Satellite organization
 INR,Indian rupee (ISO 4217 currency code)
-INRI,(a/i) Iesus Nazarenus Rex Iudæorum (Latin,"Jesus of Nazareth,King of the Jews")
+INRI,Iesus Nazarenus Rex Iudæorum (Latin for: Jesus of Nazareth,King of the Jews)
 INRIA,Institut national de recherche en informatique et en automatique
 INS,Immigration and Naturalization Service
 InSAR,Interferometric synthetic aperture radar
@@ -2506,7 +2506,7 @@ ISMC,Intelligent Sounding Meaningless Conversation
 ISO,In Search Of,International Organization for Standardization (from the Greek ίσος,isos,meaning "equal")
 ISOGP,Indian Society of Orthodontics for General Practitioners [2]
 ISP,International Standardized Profile,Internet Service Provider,Information Systems Professional
-ISPE,(a/i) International Society for Pharmacoepidemiology
+ISPE,International Society for Pharmacoepidemiology
 ISR,Intelligence,Surveillance and Reconnaissance,Israel (ISO 3166 trigram)
 ISRO,Indian Space Research Organisation
 ISS,International Shorebird Survey (North America),International Space Station
@@ -2593,11 +2593,9 @@ JCPM,Java Child Process Manager,Jesus Christ Prison Ministry
 JCS,Joint Chiefs of Staff
 JCW,Juggalo Championship Wrestling
 JD,Jack Daniel's (whiskey),Julian day,Juris Doctor (Latin,"doctor of jurisprudence")
-JDAM,(a/i) Joint Direct Attack Munition ("djay-dam")
 JDBC,Java Data Base Connectivity
 JDCC,UK Joint Doctrine and Concepts Centre,now the Development,Concepts,and Doctrine Centre,DCDC
 JDEM,Joint Dark Energy Mission
-JDK,Java Development Kit
 JDL,Jewish Defense League
 JDM,Japanese domestic market,referring specifically to automobiles and parts,Java Data Mining,Joint design manufacturing,JE[edit]
 JE,Jersey (FIPS 10-4 territory code)
@@ -2637,7 +2635,7 @@ JN,Jan Mayen Island (FIPS 10-4 territory code)
 JNI,Java Native Interface
 JNLP,Java Network Launch Protocol
 JO,Jordan (FIPS 10-4 country code; ISO 3166 digram)
-JOA,(a/i) Joint Operations Area
+JOA,Joint Operations Area
 JOD,Jordanian dinar (ISO 4217 currency code)
 Jofa,Jonssons fabriker (Swedish,"Jonsson's Factories")
 JOPES,Joint Operations Planning and Execution System
@@ -2683,7 +2681,7 @@ JTIDS,Joint Tactical Information Distribution System ("djay-tidz")
 JTLS,Joint Theater Level Simulation
 JTMD,Joint Theatre Missile Defence
 JTN,Johnston Atoll (ISO 3166 trigram; obsolete 1986)
-JTRS,(a/i) Joint Tactical Radio System ("jitters")
+JTRS,Joint Tactical Radio System ("jitters")
 JU,Juan de Nova Island (FIPS 10-4 territory code)
 JUGFET,JUnction Gate Field-Effect Transistor
 JUICE,JUpiter ICy Moon Explorer
@@ -2844,7 +2842,7 @@ la,Latin language (ISO 639-1 code)
 LAAS,Local Area Augmentation System,Los Angeles Astronomical Society
 LAB,Logistics Assault Base
 LabVIEW,Laboratory Virtual Instrumentation Engineering Workbench
-LACMA,(a/i) Los Angeles County Museum of Art
+LACMA,Los Angeles County Museum of Art
 LAD,Laser Aiming Device
 LADW,Local Air Defence Warning
 LAESI,Local Authority & Emergency Service Information
@@ -2891,7 +2889,7 @@ LCol,Lieutenant-Colonel (Canada,UK)
 LCS,League of Legends Championship Series
 LD,Laser Designator,Limited Deployment,Line of Departure
 LDA,Lateral Drift Apparatus (paratroops)
-LDAP,(a/i) Lightweight Directory Access Protocol (pronounced "ell-dap")
+LDAP,Lightweight Directory Access Protocol (pronounced "ell-dap")
 LDC,Lesser Developing/Developed Country
 LDL,Low-Density Lipoprotein
 LDS,Latter-day Saint (also "Latter Day Saint"); also used as an abbreviation by The Church of Jesus Christ of Latter-day Saints,Liberal Democracy of Slovenia
@@ -2954,8 +2952,8 @@ LLTI,Limiting Long-Term Illness,Long Lead Time Item
 LLTR,Low-Level Transit Route
 LMAO,Laughing My Ass Off (Internet shorthand)
 LMB,Lick My Balls
-LMFAO,Laughing My F**king Ass Off (Internet shorthand,electro-hop duo)
+LMFAO,"Laughing My F**king Ass Off (Internet shorthand,electro-hop duo)"
-LMN,(a/i) Lifetime Movie Network
+LMN,Lifetime Movie Network
 LMS,Like My Status (Internet shorthand)
 LMS,London Mathematical Society,London,Midland and Scottish (Railway)
 LMV,() Light Motor Vehicle
@@ -2968,7 +2966,7 @@ LNR,Ligue Nationale de Rugby (French,"National Rugby League")
 lo,Lao language (ISO 639-1 code)
 LO,Slovakia (FIPS 10-4 country code)
 LOA,Limit Of Advance
-LOC,(a/i) Level of Operational Capability,Limited Operational Capability,Lines Of Code,Lines Of Communication,see entry
+LOC,"Level of Operational Capability,Limited Operational Capability,Lines Of Code,Lines Of Communication,see entry"
 LOD,Limit of Detection,see Detection limit
 LoD,Lines of Development (UK)
 LOFAR,Low Frequency Analysis and Recording
@@ -3098,7 +3096,7 @@ Maser,Microwave Amplification by Stimulated Emission of Radiation
 MASH,Mobile Army Surgical Hospital
 MASINT,Measurement And Signature Intelligence
 MATREX,Modeling Architecture for Technology,Research & EXperimentation
-MAVS,(a/i) Mobile Artillery Vehicle System
+MAVS,Mobile Artillery Vehicle System
 MAW,Malawi (IOC trigram,but not FIFA or ISO 3166)
 MAX,Meta-reasoning Architecture for "X"
 MB,Manitoba (postal symbol),Martinique (FIPS 10-4 territory code),Medal of Bravery (Canada)
@@ -3314,9 +3312,9 @@ MoDAF,Ministry of Defence Architecture Framework ("moh-daff")
 modem,Modulator-Demodulator
 Moe,Marvel of entertainment
 MOE,Measure Of Effectiveness
-MOF,(a/i) Ministry of Finance (Japan)
+MOF,Ministry of Finance (Japan)
-MOFA,(a/i) Ministry of Foreign Affairs (Japan)
+MOFA,Ministry of Foreign Affairs (Japan)
-MOH,(a/i) Medal of Honor,Music On Hold
+MOH, Medal of Honor,Music On Hold
 MOID,Minimum Orbital Intersection Distance
 MOJWA,Movement for Oneness and Jihad in West Africa
 mol,Moldovan language (ISO 639-2 code),mole (unit)
@@ -3656,7 +3654,7 @@ NIR,Northern Ireland (FIFA trigram; not eligible for an ISO 3166 or IOC trigram)
 NISAC,U.S. National Infrastructure Simulation and Analysis Center
 NISCAP,NSA Information System Certification and Accreditation Program
 NISER,National Institute of Science Education and Research
-NIST,(a/i) National Institute of Standards and Technology
+NIST, National Institute of Standards and Technology
 NIT,National Invitation Tournament (U.S. college basketball),National Institutes of Technology (India)
 NITFS,National Imagery Transmission Format Standard
 NIU,Niue (ISO 3166 trigram)
@@ -3950,8 +3948,8 @@ OPV,Offshore Patrol Vessel
 OQ,Order Quantity,in inventory management; the quantity of new items to be ordered. Often expressed as a part of OP/OQ (when quantity OP is reached,order OQ new items)
 OR,Operating Room (surgery),Operational/Operations Research,Oregon (postal symbol),overreciprocation,when the leader of an inner circle friendship contacts a friend more than is wanted or reasonable
 or,Oriya language (ISO 639-1 code)
-ORAU,(a/i) Oak Ridge Associated Universities
+ORAU, Oak Ridge Associated Universities
-ORB,(a/i) Object Request Broker
+ORB, Object Request Broker
 ORBAT,Order of Battle
 ORD,Office of Research and Development,Operational Requirements Document
 ORF,Operational iness Float
@@ -3984,7 +3982,7 @@ OSRH,Oružane Snage Republike Hrvatske (en: Armed forces of the Republic of Croa
 OSS,Office of Strategic Services (1942-1945,forerunner of CIA)
 oss,Ossetic language (ISO 639-2 code)
 OSU,Ohio State University,Oklahoma State University
-OTA,Office of Technology Assessment,(a/i) Orthodontic Technicians Association
+OTA,Office of Technology Assessment, Orthodontic Technicians Association
 OTAC,Orthodontic Technicians Association Conference,Orthodontic Technicians Association Council
 OTB,Off The Ball,Offtrack Betting,OneSAF Testbed (a descendant of ModSAF)
 OTC,Over-The-Counter (drugs)
@@ -4016,11 +4014,11 @@ P2P,Peer-to-peer (networking)
 Pa,pascal,Protactinium
 pA,picoampere
 pa,Punjabi language (ISO 639-1 code)
-PA-(a/i) Pamela Anderson,Panama (ISO 3166 digram),Paraguay (FIPS 10-4 country code),Partial Agonist,Pennsylvania (postal symbol),petampere,PolyAmide (Nylon),Prince Albert piercing,Public Address (vocal amplification system),Public Affairs,PA 6,Nylon 6 (PolyAmide) (similarly for PA 11,12,46,66,610)
+PA- Pamela Anderson,Panama (ISO 3166 digram),Paraguay (FIPS 10-4 country code),Partial Agonist,Pennsylvania (postal symbol),petampere,PolyAmide (Nylon),Prince Albert piercing,Public Address (vocal amplification system),Public Affairs,PA 6,Nylon 6 (PolyAmide) (similarly for PA 11,12,46,66,610)
 PAA,Position Area for Artillery
 PAB,Panamanian balboa (ISO 4217 currency code)
 PABX,Private Automated Branch eXchange (company phone system)
-PAC,Pan Africanist Congress,Partial Solar Calibrator,Patriot Advanced Capabilities,Political action committee,(a/i) Primary Auditory Cortex
+PAC,Pan Africanist Congress,Partial Solar Calibrator,Patriot Advanced Capabilities,Political action committee, Primary Auditory Cortex
 PACOM,(U.S.) Pacific Command
 PADD,Personal Access Display Device (as seen in the Star Trek franchise),Petroleum Administration for Defense Districts,used for data collection in the U.S. petroleum industry
 PADI,Professional Association of Diving Instructors
@@ -4032,7 +4030,7 @@ PAI,PolyAmide Imide,Pre-Approval Inspection (pharma)
 PAK,Pakistan (ISO 3166 trigram)
 Pakistan,Punjab,Afghan states,Kashmir,sIndh,baluchiSTAN
 PAL,Phase Alternating Line (TV standard),Philippine Airlines
-PAM,(a/i) Precision Attack Missile
+PAM, Precision Attack Missile
 PAMELA,Payload for Antimatter Matter Exploration and Light-nuclei Astrophysics,Pedestrian Accessibility and Movement Environment Laboratory
 Pamida,Patrick,Michael,and David,sons of the department store chain's co-founder Jim Witherspoon
 PAN,Panama (ISO 3166 trigram),Partai Amanat Nasional (Indonesian,"National Mandate Party"),Indonesian political party,Partido Acción Nacional (Spanish,"National Action Party"),political parties in El Salvador,Mexico,and Nicaragua,Partido de Avanzada Nacional (Spanish,"National Advancement Party"),Guatemalan political party,Personal Area Network,PolyAcryloNitrile,Programa de Asistencia Nutricional (Spanish,"Nutritional Assistance Program"),U.S. federal program for nutritional needs of poor families in Puerto Rico
@@ -4118,8 +4116,8 @@ PER,Peru (ISO 3166 trigram)
 perl,usually lower case Practical Extraction and Report Language
 PES,PolyEtherSulfone
 PEST,UK Public Engagement with Science and Technology
-PET,(a/i) Personal Electronic Transactor,Pierre Elliott Trudeau,Positron Emission Tomography (as in PET scan),PolyEthylene Terephthalate (plastic),Preliminary English Test
+PET, Personal Electronic Transactor,Pierre Elliott Trudeau,Positron Emission Tomography (as in PET scan),PolyEthylene Terephthalate (plastic),Preliminary English Test
-PETA,(a/i) pentaerythritol triacrylate,People Eating Tasty Animals,People for the Ethical Treatment of Animals
+PETA, pentaerythritol triacrylate,People Eating Tasty Animals,People for the Ethical Treatment of Animals
 petawatt-
 PETE,PolyEthyleneTErephthalate
 PETP,PolyEthyleneTerePhthalate
@@ -4155,12 +4153,12 @@ PIC,Person In Charge
 PICNIC,Problem In Chair Not In Computer
 PICS,Private Investment Capital Subscription
 PID,Pelvic Inflammatory Disease,Plan Identification Number,Positive Identification,Procedural Identification,Procurement Identification Description
-PIF,(a/i) Partners in Flight
+PIF, Partners in Flight
 PIG,Pipeline Inspection Gauge
-PIM,(a/i) Parameterized Ionospheric Model,Path of Intended Motion,Pediatric Index of Mortality,Personal Information Manager/Management,Presence and Interworking Mobility,Processor-In-Memory,Program Integration Manager,Protocol Independent Multicast
+PIM, Parameterized Ionospheric Model,Path of Intended Motion,Pediatric Index of Mortality,Personal Information Manager/Management,Presence and Interworking Mobility,Processor-In-Memory,Program Integration Manager,Protocol Independent Multicast
 PIN,Personal Identification Number
 PINF,People In Need Foundation (Czech charitable organisation)
-PIPA,(a/i) Program on International Policy Attitudes
+PIPA, Program on International Policy Attitudes
 PIR,Priority Intelligence Requirement
 PIRA,Provisional Irish Republican Army
 PIREPS,Pilot Reports
@@ -4183,7 +4181,7 @@ PKU,Phenylketonuria
 PL,Ice Pellets (new style METAR Code),petalitre,Phase Line (Co-ordination Line),Poland (ISO 3166 and FIPS 10-4 country code digram)
 pL,picolitre
 pl,Polish language (ISO 639-1 code)
-PLAF,(a/i) People's Liberation Armed Forces,Pluggable look and feel,Product Line Architecture Framework
+PLAF, People's Liberation Armed Forces,Pluggable look and feel,Product Line Architecture Framework
 PLAID,Precision Location and Identification
 PLB,Personal Locator Beacon
 PLC,Public Limited Company (British)
@@ -4240,20 +4238,20 @@ POFF,Plain Old Flat File
 POG,Passionfruit,Orange and Guava
 POGO,Project On Government Oversight
 POI,Program Of Instruction
-POK,(a/i) Plane Of Knowledge
+POK, Plane Of Knowledge
 POL,Petroleum,Oils and Lubricants,Poland (ISO 3166 trigram)
 pol,Polish language (ISO 639-2 code)
 POLAD,Political Advice
 POM,Program Objective Memorandum,PolyOxyMethylene
 POMDP,Partially observable Markov decision process
 PooS,Poo Sniffer (Internet shorthand)
-POP-(a/i) Point of Presence,Post Office Protocol,Progesterone Only Pill
+POP- Point of Presence,Post Office Protocol,Progesterone Only Pill
 POR,Portugal (FIFA and IOC trigram,but not ISO 3166),Proposed Operational Requirement
 por,Portuguese language (ISO 639-2 code)
-POS-(a/i) Point Of Sale terminal (retail industry transaction computers),Piece Of S**t
+POS- Point Of Sale terminal (retail industry transaction computers),Piece Of S**t
 POSH,Port Outbound Starboard Home (alleged)
 POSSLQ,Person of the Opposite Sex Sharing Living Quarters
-POT,(a/i) Plane Of Tranquility
+POT, Plane Of Tranquility
 POTS,Plain Old Telephone Service (cf. PANS),Postural Orthostatic Tachycardia Syndrome
 POV,Point of view
 POW,Prisoner of war
@@ -4299,7 +4297,7 @@ PSA,Paralysis Society of America,Pharmaceutical Society of Australia,Pressure-Se
 PSC,Personal service corporation,Primary Somatosensory Cortex
 PSE,Palestinian Territory,Occupied (ISO 3166 trigram)
 PSG,Pacific Seabird Group
-PSI,(a/i) Portable Source Initiative
+PSI, Portable Source Initiative
 PSI,Pounds per square inch
 PSO,Peace Support Operations,Primary Standardisation Office (ABCA),Protocol Supporting Organization (of the ICANN)
 PSS,Personnel System Support
@@ -4320,13 +4318,13 @@ PTI,Pardon the Interruption
 PTL,Patrol,Primary Target Line
 PTO,Patent and Trademark Office,Please Turn Over
 PTSD,Post-Traumatic Stress Disorder
-PTUI,(a/i) Plain-Text User Interface ("pa-too-ey") (cf CLI)
+PTUI, Plain-Text User Interface ("pa-too-ey") (cf CLI)
 PU,Guinea-Bissau (FIPS 10-4 country code),Polyurethane,United States Miscellaneous Pacific Islands (ISO 3166 digram; obsolete 1986)
 Pu,Plutonium
 Pub,Publication
-PUG,(a/i) PET Users Group
+PUG, PET Users Group
-PUN,(a/i) Pull-Up Network
+PUN, Pull-Up Network
-PUP,(a/i) Pull-Up Point
+PUP, Pull-Up Point
 PUR,Puerto Rico (IOC and FIFA trigram,but not ISO 3166)
 pus,Pashto language (ISO 639-2 code)
 PUS,United States Miscellaneous Pacific Islands (ISO 3166 trigram; obsolete 1986)
@@ -4426,7 +4424,7 @@ RAM,Rolling Airframe Missile,
 RAM,Royal Air Maroc
 Ramark,RAdar MARKer
 RAOC,Rear Area Operation Centre
-RAP,(a/i) Radio Access Point,Radiological Assistance Program (U.S. Department of Energy),Rear Area Protection,Recognised [Operating/Operational] Air Picture,Recurring Advance Payment,Relational Associative Processor,Reliable Acoustic Path,Rocket-Assisted Projectile,Rule Against Perpetuities
+RAP, Radio Access Point,Radiological Assistance Program (U.S. Department of Energy),Rear Area Protection,Recognised [Operating/Operational] Air Picture,Recurring Advance Payment,Relational Associative Processor,Reliable Acoustic Path,Rocket-Assisted Projectile,Rule Against Perpetuities
 RARDE,UK Royal Armament Research and Development Establishment (1962-1991)
 RARE,Rapid Acquisition with Relaxation Enhancement (MRI technique)
 RASC,Royal Army Service Corp,Former corps of British Army
@@ -4435,7 +4433,7 @@ Rb,Rubidium
 RB,Running Back (football)
 RBAR,Row By Agonizing Row,a derogatory way of describing a technique of scanning a set of records in a database to update or examine the contents of each one. This is the technique of last resort in most cases,since most database operations are optimized when using set based analysis instead of the RBAR method.
 RBI,Runs Batted In
-RBOC,(a/i) Regional Bell Operating Company ("Baby Bell")
+RBOC, Regional Bell Operating Company ("Baby Bell")
 RC,see entry
 RCA,Radio Corporation of America,Root Cause Analysis,Royal Canadian Artillery,Royal City Avenue (famous entertainment zone in Thailand)
 RCAF,Royal Canadian Air Force
@@ -4450,7 +4448,7 @@ RCT,Randomized Controlled Trial,Robotically Controlled Telescope,Rugby club toul
 RD,Radio Disney
 RDA,Research,Development,and Acquisition,Recommended Daily Allowance (Nutrition)
 RDD,Radiological Dispersion Device
-RDDL,(a/i) Resource Directory Description Language ("riddle")
+RDDL, Resource Directory Description Language ("riddle")
 RDECOM,(U.S. Army) Research,Development and Engineering Command
 RDM,Remotely Delivered/Deliverable Mine
 RDO,Rapid,Decisive Operation,Regular Day Off,Remote Data Objects
@@ -4506,7 +4504,7 @@ RILA,Retail Industry Leaders Association
 RIM,Remote integrated multiplexer,Australian term for a digital loop carrier,Research In Motion,former name of the BlackBerry company,Revolutionary Internationalist Movement (Maoist organization),Royal Indian Marine,former navy of British colonial India
 RIMVS,Retinal Imaging Machine Vision System
 RINO,Republican In Name Only[1]
-RIP-(a/i) Relief In Place,requiesca[n]t in pace (Latin for "may he/she/they rest in peace")
+RIP- Relief In Place,requiesca[n]t in pace (Latin for "may he/she/they rest in peace")
 RIS,Range Instrumentation System,Réseau Info Sports (French,roughly "Sports News Network" — Canadian French-language TV channel)
 RISC,Reduced Instruction Set Computer
 RISD,Rhode Island School of Design ("riz-dee")
@@ -4536,15 +4534,15 @@ RNZ,Radio New Zealand
 RNZI,Radio New Zealand International
 RO,Range Only,Red Orchestra,Romania (ISO 3166 and FIPS 10-4 country code digram)
 ro,Romanian language (ISO 639-1 code)
-ROA,(a/i) Rate Of Ascent
+ROA, Rate Of Ascent
 ROC,Receiver Operating Characteristic (statistics),Regional Operations Centre,Republic Of China,Roc-A-Fella Records,Regional Organisations of Councils
-ROD,(a/i) Rate Of Descent,Record Of Decisions,Report Of Discrepancy
+ROD, Rate Of Descent,Record Of Decisions,Report Of Discrepancy
 ROE,Rules Of Engagement
 ROFLOL,Rolling On the Floor Laughing Out Loud
 roh,Raeto-Romansh language (ISO 639-2 code)
 ROH,Ring of Honor
 ROI,Return On Investment,Republic of Ireland.
-ROK,(a/i) Republic of Korea
+ROK, Republic of Korea
 ROL,Romanian leu (ISO 4217 currency code)
 ROM,-Only Memory,Refuel On the Move,Royal Ontario Museum
 ron,Romanian language (ISO 639-2 code)
@@ -4557,7 +4555,7 @@ ROU,Romania (ISO 3166 trigram)
 ROV,Remotely Operated Vehicle
 ROW,Right Of Way,Rest Of the World
 ROWPU,Reverse Osmosis Water Purification Unit ("roe-pew")
-ROZ,(a/i) Restricted Operations Zone
+ROZ, Restricted Operations Zone
 RP,Philippines (FIPS 10-4 country code),Release Point,Role-Playing [relationship potential]
 RPA,Regional Plan Association
 RPD,Recognition-Primed Decision-making
@@ -4628,12 +4626,12 @@ RWS,Remote Weapon Station
 Rx,Medical prescription (possibly from Latin "recipere","to take": see entry)
 RX,Receive
 SA,Sand (METAR Code),Saudi Arabia (ISO 3166 and FIPS 10-4 country code digram),Sexaholics Anonymous,sine anno (Latin,“without year”),Situational awareness,South Africa,(i/s) South Australia (postal symbol),Standards Australia,Sturmabteilung (German,“Storm Detachment”,Nazi forerunner and rival of SS),S.A.,designation for a corporation in many European countries; see article for meanings
-SAA,Saudi Arabian Airlines,former name of Saudia,Sex Addicts Anonymous,South African Airways,Southern Athletic Association,Standards Association of Australia,a former name of Standards Australia,SAAB —  Svenska Aeroplan AB (Swedish aircraft manufacturer; also refers to its former auto manufacturing arm),SAAFR — (a/i) Standard use Army Aircraft Flight Route (“safer”),SAAMI —  Sporting Arms and Ammunition Manufacturers' Institute (“sammy”),SAARC —  South Asian Association for Regional Cooperation,SAB —  Soprano Alto Baritone,Sabena —  Société anonyme belge d'exploitation de la navigation aérienne (French for “Belgian Company for Exploiting Aerial Navigation”,1923-2001),SABIC —  Saudi Basic Industries Corporation,SABR —  Society for American Baseball Research
+SAA,Saudi Arabian Airlines,former name of Saudia,Sex Addicts Anonymous,South African Airways,Southern Athletic Association,Standards Association of Australia,a former name of Standards Australia,SAAB —  Svenska Aeroplan AB (Swedish aircraft manufacturer; also refers to its former auto manufacturing arm),SAAFR —  Standard use Army Aircraft Flight Route (“safer”),SAAMI —  Sporting Arms and Ammunition Manufacturers' Institute (“sammy”),SAARC —  South Asian Association for Regional Cooperation,SAB —  Soprano Alto Baritone,Sabena —  Société anonyme belge d'exploitation de la navigation aérienne (French for “Belgian Company for Exploiting Aerial Navigation”,1923-2001),SABIC —  Saudi Basic Industries Corporation,SABR —  Society for American Baseball Research
 SAC,Standards Activity Committee (of SISO),U.S. Strategic Air Command (1946-1992),SACAT —  Semi Attended Customer Activated Terminal (Supermarket checkout),SACEUR —  Supreme Allied Commander EURope,SACLANT —  Supreme Allied Commander atLANTic,SACLOS —  Semi-Automatic Command to Line of Sight
 SAD,Seasonal Affective Disorder,Situational Awareness Display,SADD —  originally Students Against Drunk Driving,now Students Against Destructive Decisions (U.S. national school-related group)
 SADL,Situation Awareness Data Link (“saddle”),Structural Architecture Description Language
 SAE,Society of Automotive Engineers[1],Stamped addressed envelope,SAFER —  Steel And Foam Energy Reduction,SAFICT —  Software Agents as Facilitators of Interoperability in Collective Training,sag —  Sango language (ISO 639-2 code),SAG —  Screen Actors Guild,SAGAT —  Situation Awareness Global Assessment Technique,SAGE —  Semi-Automatic Ground Environment (simulation),SAHB —  Sensational Alex Harvey Band,SAIC —  Science Applications International Corporation
-SALT-(a/i) Save A Life Today (SALT) Alert; Emergency Contact System,Southern African Large Telescope,Strategic Arms Limitation s
+SALT- Save A Life Today (SALT) Alert; Emergency Contact System,Southern African Large Telescope,Strategic Arms Limitation s
 SAM,Sequential-Access Memory,Sociedad Aeronáutica de Medellín,Surface-to-Air Missile
 Sambo,(p/a) Samooborona bez oruzhiya (Russian: "Самооборона без оружия",literally "self-defense without weapons")
 san,Sanskrit language (ISO 639-2 code),Storage Area Network
@@ -4672,8 +4670,8 @@ SGS,South Georgia and the South Sandwich Islands (ISO 3166 trigram),Svalbard Gro
 SH,Saint Helena (ISO 3166 digram),SONATRACH (Algerian petroleum company)
 SHAC,Stop Huntingdon Animal Cruelty,Student Health Action Coalition,SHAPE —  Supreme Headquarters Allied Powers Europe,SHF —  Super High Frequency,SHN —  Saint Helena (ISO 3166 trigram)
 SHO,Showtime (see also sho.com)
-SI,Slovenia (ISO 3166 and FIPS 10-4 country code digram),Socialist International,Sports Illustrated,Système International (French,International System of Units),SIA —  Singapore Airlines (ICAO code),SIA —  Survivors of Incest Anonymous,SIAM —  Society for Industrial and Applied Mathematics,SIC —  Standard Industrial Classification,SICS — (a/i) Swedish Institute of Computer Science,SIDS —  Sudden infant death syndrome,SIDU —  select,insert,delete,update. See Create,read,update and delete,SIF —  Selective Identification Feature,SIFF —  Successor IFF
+SI,Slovenia (ISO 3166 and FIPS 10-4 country code digram),Socialist International,Sports Illustrated,Système International (French,International System of Units),SIA —  Singapore Airlines (ICAO code),SIA —  Survivors of Incest Anonymous,SIAM —  Society for Industrial and Applied Mathematics,SIC —  Standard Industrial Classification,SICS —  Swedish Institute of Computer Science,SIDS —  Sudden infant death syndrome,SIDU —  select,insert,delete,update. See Create,read,update and delete,SIF —  Selective Identification Feature,SIFF —  Successor IFF
-SIG,Schweizerische Industrie Gesellschaft (German,"Swiss Industry Company"). See also SIG Sauer,a firearms manufacturer spun off from the aforementioned company in 2000.,.signature (UNIX shell/Internet standard file name),(a/i) Special Interest Group,SIGCAT —  Special Interest Group for CD-ROM Applications and Technology,SIGINT —  Signals Intelligence,SIGMET —  Significant Meteorological Information
+SIG,Schweizerische Industrie Gesellschaft (German,"Swiss Industry Company"). See also SIG Sauer,a firearms manufacturer spun off from the aforementioned company in 2000.,.signature (UNIX shell/Internet standard file name), Special Interest Group,SIGCAT —  Special Interest Group for CD-ROM Applications and Technology,SIGINT —  Signals Intelligence,SIGMET —  Significant Meteorological Information
 SIIT,Saskatchewan Indian Institute of Technologies (Canadian university),Sirindhorn International Institute of Technology (Thai university),Stateless IP/ICMP Translation algorithm,SIMAC —  Semantic Interaction with Music Audio Contents,SIMLAS —  Soldier Integrated Multipurpose Laser System,SIMM —  Single In-line Memory Module,SIMNET —  SIMulator NETwork,later SIMulation NETwork,SIMNET-D,SIMNET-Developmental,SIMP —  Strongly Interacting Massive Particle
 SIMPLE,Satellite Interactive Multimedia Platform for Low-cost Earth stations,Savings Incentive Match Plan for Employees (as used in SIMPLE IRA),Standard Interface for Multiple Platform Link Evaluation (NATO STANAG 5602),sin —  Sinhalese language (ISO 639-2 code),SIN —  Social Insurance Number (Canada),SINCGARS —  SINgle Channel Ground and Airborne Radio System
 SIP,Session Initiation Protocol,State Implementation Plan,System Improvement Program,Systematic Investment Plan,SIPP —  Self-Invested Personal Pension
@@ -4700,7 +4698,7 @@ SOB,Son Of a Bitch,Same Old Bullshit,SOC —  Sector Operations Centre,SOCCSKSAR
 SoCon,Southern Conference (U.S. college sports)
 SOD,School Of Dentistry,Statement Of Difference[s],Statement Of Direction,Statement Of Documentation,Statement Of Duty/Duties
 SOE,Secret Of Evermore,Special Operations Executive (WWII British organization),State Of Emissions (EW)
-SOF-(a/i) Special Operations Force,Status of Forces,SOFIA —  Stratospheric Observatory For Infrared Astronomy
+SOF- Special Operations Force,Status of Forces,SOFIA —  Stratospheric Observatory For Infrared Astronomy
 SOGAT,Society of Graphical and Allied Trades,Former British printing union,SOHC —  Single-OverHead-Cam engine,SOHO —  Solar and Heliospheric Observatory,SOI —  Signal Operating Instruction,SOL —  Shit Out of Luck,SOLIS —  Synoptic Optical Long-term Investigations of the Sun,som —  Somali language (ISO 639-2 code)
 SOM,Simulation Object Model,Somalia (ISO 3166 trigram),Sonar —  SOund Navigation And Ranging
 SOP,Standing/Standard Operating Procedure,State of Play
@@ -4709,7 +4707,7 @@ SOS,Somali shilling (ISO 4217 currency code),Save Our Souls,SOSTAR —  Stand-Of
 South-Sulphur/Sulfur,S0-9[edit],S4C —  Sianel Pedwar Cymru (Welsh,"Channel Four Wales"),SA[edit],sa —  Sanskrit language (ISO 639-1 code)
 SP,Security Police,Self-Propelled,Shore Patrol,Spain (FIPS 10-4 country code),Start Point,Strong Point,spa —  Spanish language (ISO 639-2 code),SPAAG —  Self-Propelled Anti-Aircraft Gun,SPACECOM —  (U.S.) Space Command,Spaser —  Surface plasmon amplification by stimulated emission of radiation,SPC —  Secretariat of the Pacific Community,SPCO —  Single-Pole Change Over
 Sp,Special,Spring tide (nautical charts),sine prole (Latin,“without offspring”)
-SPL,Scottish Premier League,Superior Parietal Lobule,Sound Pressure Level,SPM —  Saint Pierre and Miquelon (ISO 3166 trigram),SPOD — (a/i) Sea Port of Debarkation,SPOE — (a/i) Sea Port of Embarkation,SPOT —  Satellite pour l'observation de la Terre (French,“Satellite for Earth Observation”),SPQR —  Senatus Populusque Romanus (Latin “The Senate and the People of Rome”),sps —  sine prole superstite (Latin,“without surviving issue”),SPS —  Standard Positioning Service (GPS),SPST —  Single-Pole Single-Throw,SQ[edit],sq —  Albanian language (ISO 639-1 code),SQ —  Sound Quality,SQ —  Standard Quality,sqi —  Albanian language (ISO 639-2 code),SQL — (i/a) Structured Query Language (“seek-well”),SQUID —  Superconducting QUantum Interference Device,SR[edit],sr —  Serbian language (ISO 639-1 code),Sr —  Strontium
+SPL,Scottish Premier League,Superior Parietal Lobule,Sound Pressure Level,SPM —  Saint Pierre and Miquelon (ISO 3166 trigram),SPOD —  Sea Port of Debarkation,SPOE —  Sea Port of Embarkation,SPOT —  Satellite pour l'observation de la Terre (French,“Satellite for Earth Observation”),SPQR —  Senatus Populusque Romanus (Latin “The Senate and the People of Rome”),sps —  sine prole superstite (Latin,“without surviving issue”),SPS —  Standard Positioning Service (GPS),SPST —  Single-Pole Single-Throw,SQ[edit],sq —  Albanian language (ISO 639-1 code),SQ —  Sound Quality,SQ —  Standard Quality,sqi —  Albanian language (ISO 639-2 code),SQL — (i/a) Structured Query Language (“seek-well”),SQUID —  Superconducting QUantum Interference Device,SR[edit],sr —  Serbian language (ISO 639-1 code),Sr —  Strontium
 SR,Sound Reinforcement,Supply Route,Suriname (ISO 3166 digram),Sveriges Radio (Swedish Radio Ltd),SR —  Sustained release of a drug
 SRAM,Scott (King),Ray (Day),SAM (Patterson) — founders of bicycle component manufacturer SRAM Corporation,Static Random Access Memory (“ess-ram”),SR-ATGW —  Short-Range Anti-Tank Guided Weapon,SRB —  Solid Rocket Booster,SRBM —  Short-Range Ballistic Missile (cf. IRBM,ICBM),SRC —  Scheduled Removal Component,srd —  Sardinian language (ISO 639-2 code)
 SRD,Science Requirements Document,Surinam dollar (ISO 4217 currency code),SREL —  Savannah River Ecology Laboratory
@@ -4752,7 +4750,7 @@ SWAT,Special Weapons And Tactics
 SWE —  Sweden (ISO 3166 trigram)
 swe,Swedish language (ISO 639-2 code)
 SWF,Single White Female
-SWG,Surface Warfare Group,Symbology Working Group,SWHR —  Society for Women's Health Research,SWIG —  Simplified Wrapper and Interface Generator,SWIR — (a/i) Short Wave InfraRed (“ss-why-are” or “swhirr”)
+SWG,Surface Warfare Group,Symbology Working Group,SWHR —  Society for Women's Health Research,SWIG —  Simplified Wrapper and Interface Generator,SWIR —  Short Wave InfraRed (“ss-why-are” or “swhirr”)
 SWLABR,She Was Like A Bearded Rainbow,Cream song (Bruce,Clapton and Baker),SWORD —  Subjective WORkload Dominance,SWORDS —  Special Weapons Observation Reconnaissance Detection System,SWOT —  Strengths,Weaknesses,Opportunities,Threats (mnemonic)
 SWP,Special Working Party (“swipp”),Systematic Westing Plan (a plan of periodic westing of shares or mutual funds worth a fixed amount of money),Skill With Prizes (UK pub quiz machines — quality titles include: Pub Quiz,Quiz City,Frog in a Liquidizer,Who Wants To Win a Tenner?),SWT —  Sea Water Tank,SWV —  Sisters With Voices (American female R&B vocal group),SWZ —  Swaziland (ISO 3166 trigram),SX[edit],SX —  Sonic X
 SXM,Scanning X-ray Microscope,Sint Maarten (ISO 3166 trigram),Stream X-Machine,SY[edit],SY —  Syria (ISO 3166 and FIPS 10-4 country code digram),SYC —  Seychelles (ISO 3166 trigram),SYP —  Syrian pound (ISO 4217 currency code),SYR —  Syria (ISO 3166 trigram),Syriza —  Synaspismós Rizospastikís Aristerás (Greek Συνασπισμός Ριζοσπαστικής Αριστεράς,"Coalition of the Radical Left"),SysML —  System Modeling Language,Sysop —  System Operator,SZ[edit]
@@ -4840,7 +4838,7 @@ Team,Together everyone achieves more
 TEAMS,The East African Marine System (fiber optic cable)
 TED,Technology Entertainment Design prize
 TEETH,Tried Everything Else,Try Homeopathy (medical diagnosis in-joke)
-TEL,(a/i) Transporter,Erector and Launcher
+TEL, Transporter,Erector and Launcher
 tel,Telugu language (ISO 639-2 code)
 TELAR,Transporter,Erector,Launcher And Radar
 TENCAP,Tactical Exploitation of National Capabilities
@@ -4869,7 +4867,7 @@ th,Thai language (ISO 639-1 code)
 Th,Thorium
 tha,Thai language (ISO 639-2 code)
 THA,Thailand (ISO 3166 trigram)
-THAAD,(a/i) Terminal High Altitude Area Defence
+THAAD, Terminal High Altitude Area Defence
 THB,Thai baht (ISO 4217 currency code)
 THEGENTRY,The High-End Group of Earth's New Technologies Research Yield
 THEL,Tactical High Energy Laser ACTD
@@ -4916,7 +4914,7 @@ TLS,Timor-Leste (ISO 3166 trigram),Times Literary Supplement,TM[edit]
 TM,Technical Manual,Theatre Missile,Thematic Mapper,trademark (often written in small superscript type: TM or ™),Turing machine,Turkmenistan (ISO 3166 digram) Tympanic Membrane
 Tm,Terametre
 TMA,Terminal Manoeuvring Area (restricted flying zone),Texas Medical Association,Tristeza y muerte de agave (Spanish,"wilting and death of agave"),a disease affecting the blue agave,from which the popular spirit tequila is produced
-TMAP,(a/i) Texas Medication Algorithm Project
+TMAP, Texas Medication Algorithm Project
 TMC,The Movie Channel
 TMD,Theatre Missile Defence
 TMDK,The Mighty Don't Kneel (Australian professional wrestling stable also active in Japan)
@@ -4937,7 +4935,7 @@ tn,Tswana language (ISO 639-1 code)
 TNA,Total Nonstop Action Wrestling
 TND,Tunisian dinar (ISO 4217 currency code)
 TNO,Trans-Neptunian Object
-TNT,Thomas Nationwide Transport,an Australian company that was one of the predecessors to the former TNT N.V. and the current TNT Express,TriNitroToluene,(a/i) Turner Network Television,TO[edit]
+TNT,Thomas Nationwide Transport,an Australian company that was one of the predecessors to the former TNT N.V. and the current TNT Express,TriNitroToluene, Turner Network Television,TO[edit]
 TO,"Task order, Togo (FIPS 10-4 country code), Tonga (ISO 3166 digram), Tongan language (ISO 639-1 code)"
 TOA,Table Of Authorities,Total Obligation Authority (accounting)
 TOAD,Temporary,Obsolete,Abandoned,or Derelict site (urbanism),Towed Optical Assessment Device
@@ -5150,7 +5148,7 @@ URBSFA,Union royale belge des sociétés de football association (French for Roy
 urd,Urdu language (ISO 639-2 code)
 URD,User Requirements Document
 URI,Uniform Resource Identifier,University of Rhode Island
-URL,(a/i) Uniform Resource Locator ("earl")
+URL, Uniform Resource Locator ("earl")
 URU,Uruguay (IOC and FIFA trigram,but not ISO 3166)
 URY,Uruguay (ISO 3166 trigram)
 US,United States (also ISO 3166 and FIPS 10-4 country code digram)
@@ -5161,7 +5159,7 @@ USAAVNC,U.S. Army AViatioN Center,Fort Rucker,Alabama
 USAF,United States Air Force
 USAFSPC,U.S. Air Force Space Command
 USAIC,U.S. Army Infantry Center,U.S. Army Intelligence Center
-USAID,(a/i) United States Agency for International Development
+USAID, United States Agency for International Development
 USAP,Union Sportive des Arlequins Perpignanais,United States Antarctic Program
 USAPATRIOT,Uniting and Strengthening America by Providing Appropriate Tools Required to Intercept and Obstruct Terrorism
 USAREUR,United States Army Europe
@@ -5206,7 +5204,7 @@ UST,Underground Storage Tank
 USTRANSCOM,United States Transportation Command
 USWNT,United States women's national (soccer) team
 UT,Universal Time
-UTEP,(a/i) University of Texas at El Paso (pronounced you-tep)
+UTEP, University of Texas at El Paso (pronounced you-tep)
 UTM,Universal Transverse Mercator (geographical co-ordinate system)
 UU,Unitarian Universalism,University of Utah,Unseen University
 UUA,Unitarian Universalist Association
@@ -5266,7 +5264,7 @@ VFT,Virtual Function Table
 VFW,Veterans of Foreign Wars
 VG,British Virgin Islands (ISO 3166 digram)
 VGB,British Virgin Islands (ISO 3166 trigram)
-VH1,(a/i) Video Hits One
+VH1, Video Hits One
 VHF,Very High Frequency
 VI,6 (in Roman numerals),British Virgin Islands (FIPS 10-4 territory code),U.S. Virgin Islands (postal symbol; ISO 3166 digram),vide infra (Latin,"see below"),Virtual Instrument (LabVIEW)
 vi,Vietnamese language (ISO 639-1 code)
@@ -5286,7 +5284,7 @@ VIVO,Video In Video Out
 VJ,Video Jockey
 VK,Australia (ham radio code),Västerbottens-Kuriren,a Swedish daily newspaper
 VLA,Very Large Array,(UK) Veterinary Laboratories Agency
-VLAD,(a/i) Vertical Line Array DIFAR
+VLAD, Vertical Line Array DIFAR
 VLBA,Very Long Baseline Array
 VLF,Very Low Frequency
 VLIW,Very Long Instruction Word
@@ -5313,10 +5311,9 @@ vol,Volapük language (ISO 639-2 code)
 VOLT,Visual OpenType Layout Tool
 Volvo,Swedish supplier of commercial vehicles owned by Ford Motor Company. "Volvo" means "I roll" in Latin.
 VON,Victorian Order of Nurses
-VOR,VHF Omnidirectional Ranging
 VOR,Voice of Russia
 VOX,Voice Operated oscillator
-VP,(a/i) Vice-President ("veep")
+VP, Vice-President ("veep")
 VPN,Virtual Private Network
 VQ,Vector Quantization,U.S. Virgin Islands (FIPS 10-4 territory code)
 VR,Virtual Reality
@@ -5382,7 +5379,7 @@ WEEE,Waste Electrical and Electronic Equipment
 WEF,World Economic Forum
 WEM,West Edmonton Mall
 WEU,Western European Union
-WEZ,(a/i) Weapon Engagement Zone
+WEZ, Weapon Engagement Zone
 WF,Wallis and Futuna Islands (ISO 3166 digram)
 WFC,Women's Forage Corps (World War II UK)
 WFD,Weapon of Focused Destruction
@@ -5402,7 +5399,7 @@ WIA,Wounded In Action,Wireless Institute of Australia (Amateur Radio)
 WIIFM,What's in it for me?
 WIMP,Weakly Interacting Massive Particle,Windows,Icons,Menus,Pointers
 WIP,Work In Progress
-WIPO,(a/i) World Intellectual Property Organization
+WIPO, World Intellectual Property Organization
 WIPP,[Nuclear] Waste Isolation Pilot Plant
 WIYN,Wisconsin Indiana Yale NOAO telescope consortium
 WK,Wake Island (ISO 3166 digram,obsolete 1986)
@@ -5428,7 +5425,7 @@ wo,Wolof language (ISO 639-1 code)
 WOF,Width of Fabric
 WOFT,Waste Of Fucking Time
 WOFTAM,Waste Of Fucking Time And Money
-WOI,(a/i) Wheels Of Italy
+WOI, Wheels Of Italy
 wol,Wolof language (ISO 639-2 code)
 WOM,Write Only Memory
 WOS,Wilson Ornithological Society
@@ -5466,7 +5463,7 @@ WSDL,Web Services Description Language
 WSJ,(The) Wall Street Journal
 WSL,White Star Line (shipping company),Women's Super League,used to describe England's top women's association football league and top women's rugby union competition,Workers' Socialist League (UK political party)
 WSM,Samoa (ISO 3166 trigram; from Western Samoa),Winchester Short Magnum (family of rifle cartridges)
-WSMR,(a/i) White Sands Missile Range ("whiz-murr")
+WSMR, White Sands Missile Range ("whiz-murr")
 WSROC,Western Sydney Regional Organisation of Councils
 WSSM,Winchester Super Short Magnum (family of rifle cartridges)
 WST,Water Soluble Tetrazolium (assay),Samoan tālā (ISO 4217 currency code)
@@ -5586,7 +5583,7 @@ YA,Yottaampere,Young Adult
 Ya,Yottayear
 YaBPr,Yet another Brother Pat rant
 YABSLAG,Yet another boy singing like a girl
-YAC,(a/i) Youth-Adult Committee
+YAC, Youth-Adult Committee
 YAFLA,Yet Another Five Letter Abbreviation
 YAP,Young Aspiring Professional
 YB,Youcef Benzouada (Southern Algerian name)

Data/Abbr/military.csv

@@ -360,7 +360,6 @@ IRCM,Infra-Red CounterMeasure
 IRR,Individual Ready Reserve
 IRS,Inertial Reference System
 IRST,Infra-Red Search-and-Track
-ISA,International Standard Atmosphere
 ISOPREP,Isolated Personnel Report
 IT,Information Technology
 JA,Judge Advocate

Data/SI-prefixes.csv

@@ -0,0 +1,24 @@
+FACTOR, FACTOR_FULLY_WRITTEN,                       NAME,     SYMBOL,  EXAMPLE
+10³⁰,   1 000 000 000 000 000 000 000 000 000 000,  Quetta,   Q,       1 Qm
+10²⁷,   1 000 000 000 000 000 000 000 000 000,      Ronna,    R,       1 Rm
+10²⁴,   1 000 000 000 000 000 000 000 000,          Yotta,    Y,       1 Ym
+10²¹,   1 000 000 000 000 000 000 000,              Zetta,    Z,       1 Zm
+10¹⁸,   1 000 000 000 000 000 000,                  Exa,      E,       1 Em
+10¹⁵,   1 000 000 000 000 000,                      Peta,     P,       1 Pm
+10¹²,   1 000 000 000 000,                          Tera,     T,       1 Tm
+10⁹,    1 000 000 000,                              Giga,     G,       1 Gm
+10⁶,    1 000 000,                                  Mega,     M,       1 Mm
+10³,    1 000,                                      Kilo,     k,       1 km
+10⁰,    1,                                          ,         ,        1 m
+10⁻¹,   0.1,                                        Deci,     d,       1 dm
+10⁻²,   0.01,                                       Centi,    c,       1 cm
+10⁻³,   0.001,                                      Milli,    m,       1 mm
+10⁻⁶,   0.000 001,                                  Micro,    µ,       1 µm
+10⁻⁹,   0.000 000 001,                              Nano,     n,       1 nm
+10⁻¹²,  0.000 000 000 001,                          Pico,     p,       1 pm
+10⁻¹⁵,  0.000 000 000 000 001,                      Femto,    f,       1 fm
+10⁻¹⁸,  0.000 000 000 000 000 001,                  Atto,     a,       1 am
+10⁻²¹,  0.000 000 000 000 000 000 001,              Zepto,    z,       1 zm
+10⁻²⁴,  0.000 000 000 000 000 000 000 001,          Yocto,    y,       1 ym
+10⁻²⁷,  0.000 000 000 000 000 000 000 000 001,      Ronto,    r,       1 rm
+10⁻³⁰,  0.000 000 000 000 000 000 000 000 000 001,  Quecto,   q,       1 qm

Data/basic-apps.csv

@@ -1,26 +1,27 @@
-AppName,Category,AppID
+APPNAME,              CATEGORY,            APPID
-"7-Zip",		"file tool",		XPDNKVCX4QD2DC
+"7-Zip",              "file tool",         "XPDNKVCX4QD2DC"
-"Aquile Reader",	"ebook reader",		9P08T4JLTQNK
+"Aquile Reader",      "ebook reader",      "9P08T4JLTQNK"
-"CrystalDiskInfo",	"HDD/SSD tool",		XP8K4RGX25G3GM
+"CrystalDiskInfo",    "HDD/SSD tool",      "XP8K4RGX25G3GM"
-"Google Chrome",	"desktop browser",	Google.Chrome
+"Google Chrome",      " desktop browser",  "Google.Chrome"
-"Dopamine",		"audio player",		Digimezzo.Dopamine.2
+"Dopamine",           "audio player",      "Digimezzo.Dopamine.2"
-"Dropbox",		"file sync",		Dropbox.Dropbox
+"Dropbox",            "file sync",         "Dropbox.Dropbox"
-"Git",			"code management",	Git.Git
+"Git for Windows",    "code management",   "Git.Git"
-"IrfanView",		"image viewer",		9PJZ3BTL5PV6
+"IrfanView",          "image viewer",      "9PJZ3BTL5PV6"
-"inSSIDer",		"Wifi tool",		MetaGeek.inSSIDer
+"inSSIDer",           "Wifi tool",         "MetaGeek.inSSIDer"
-"LibreOffice",		"office suite",		TheDocumentFoundation.LibreOffice
+"LibreOffice",        "office suite",      "TheDocumentFoundation.LibreOffice"
-"Microsoft Teams",	"messenger",		XP8BT8DW290MPQ
+"Microsoft Teams",    "messenger",         "XP8BT8DW290MPQ"
-"Mozilla Firefox",	"desktop browser",	9NZVDKPMR9RD
+"Mozilla Firefox",    "desktop browser",   "9NZVDKPMR9RD"
-"Mozilla Thunderbird",	"email client",		Mozilla.Thunderbird
+"Mozilla Thunderbird","email client",      "Mozilla.Thunderbird"
-"Netflix",		"video player",		9WZDNCRFJ3TJ
+"Mp3tag",             "mp3 tag editor",    "9NN77TCQ1NC8"
-"Notepad++",		"text editor",		Notepad++.Notepad++
+"Netflix",            "video player",      "9WZDNCRFJ3TJ"
-"One Calendar",		"desktop calendar",	9WZDNCRDR0SF
+"Notepad++",          "text editor",       "Notepad++.Notepad++"
-"Signal",		"messenger",		OpenWhisperSystems.Signal
+"One Calendar",       "desktop calendar",  "9WZDNCRDR0SF"
-"smartmontools",	"HDD/SSD tool",		smartmontools.smartmontools
+"Signal",             "messenger",         "OpenWhisperSystems.Signal"
-"Spotify",		"music and podcasts",	9NCBCSZSJRSB
+"smartmontools",      "HDD/SSD tool",      "smartmontools.smartmontools"
-"Typora",		"Markdown editor",	Typora.Typora
+"Spotify",            "music and podcasts","9NCBCSZSJRSB"
-"Visual Studio Code",	"code editor",		XP9KHM4BK9FZ7Q
+"Typora",             "Markdown editor",   "Typora.Typora"
-"VLC",			"media player",		XPDM1ZW6815MQM
+"Visual Studio Code", "code editor",       "XP9KHM4BK9FZ7Q"
-"Windows Terminal",	"terminal application",	9N0DX20HK701
+"VLC",                "media player",      "XPDM1ZW6815MQM"
-"WhatsApp",		"messenger",		9NKSQGP7F2NH
+"Windows Terminal",   "terminal application", "9N0DX20HK701"
-"Zoom",			"video conferences",	Zoom.Zoom
+"WhatsApp",           "messenger",         "9NKSQGP7F2NH"
+"Zoom",               "video conferences",  "Zoom.Zoom"

Data/git-repos.csv

@@ -1,27 +1,28 @@
-Category,FolderName,    	Branch,  Full,	URL
+GROUP, FOLDERNAME,        BRANCH,  FULL,   URL
-Dev,	 base256unicode,	main,    no,	"git@github.com:fleschutz/base256unicode"
+Dev,   base256unicode,    main,    no,     "git@github.com:fleschutz/base256unicode"
-Dev,	 bazel,			master,	 no,	"git@github.com:bazelbuild/bazel"
+Dev,   bazel,             master,  no,     "git@github.com:bazelbuild/bazel"
-Dev,	 cmake,			master,	 no,	"git@github.com:Kitware/CMake"
+Dev,   cmake,             master,  no,     "git@github.com:Kitware/CMake"
-Fun,	 cmatrix,		master,	 no,	"git@github.com:abishekvashok/cmatrix"
+Fun,   cmatrix,           master,  no,     "git@github.com:abishekvashok/cmatrix"
-Tool,	 cmark,			master,	 no,	"git@github.com:commonmark/cmark"
+Tool,  cmark,             master,  no,     "git@github.com:commonmark/cmark"
-Dev,	 CWTS,			master,  no,	"git@github.com:fleschutz/CWTS"
+Dev,   CWTS,              master,  no,     "git@github.com:fleschutz/CWTS"
-Tool,	 elasticsearch,		main,	 no,	"git@github.com:elastic/elasticsearch"
+Math,  CSS,               main,    no,     "git@github.com:chikitpao/CSS"
-Tool,	 go-ipfs,		master,	 no,	"git@github.com:ipfs/go-ipfs"
+Tool,  elasticsearch,     main,    no,     "git@github.com:elastic/elasticsearch"
-Tool,	 grafana,		main,	 no,	"git@github.com:grafana/grafana"
+Tool,  go-ipfs,           master,  no,     "git@github.com:ipfs/go-ipfs"
-Tool,	 leon,          	master,  no,	"git@github.com:leon-ai/leon"
+Tool,  grafana,           main,    no,     "git@github.com:grafana/grafana"
-Dev,	 llvm,			master,  no,	"git@github.com:llvm/llvm-project"
+Tool,  leon,              master,  no,     "git@github.com:leon-ai/leon"
-Math,	 LSS,			master,	 no,	"git@github.com:fleschutz/LSS"
+Dev,   llvm,              master,  no,     "git@github.com:llvm/llvm-project"
-Dev,	 ninja,			master,  no,	"git@github.com:ninja-build/ninja"
+Math,  LSS,               master,  no,     "git@github.com:fleschutz/LSS"
-Libs,	 opencv,		master,  no,	"git@github.com:opencv/opencv"
+Dev,   ninja,             master,  no,     "git@github.com:ninja-build/ninja"
-Tool,	 operating-systems,	main,	 no,	"git@github.com:fleschutz/operating-systems"
+Libs,  opencv,            master,  no,     "git@github.com:opencv/opencv"
-Shell,	 PowerShell,		master,  no,	"git@github.com:fleschutz/PowerShell"
+Tool,  operating-systems, main,    no,     "git@github.com:fleschutz/operating-systems"
-Shell,	 pwsh,			master,  no,	"git@github.com:PowerShell/PowerShell"
+Shell, PowerShell,        master,  no,     "git@github.com:fleschutz/PowerShell"
-Dev,	 protobuf,		main,	 no,	"git@github.com:protocolbuffers/protobuf"
+Shell, pwsh,              master,  no,     "git@github.com:PowerShell/PowerShell"
-Dev,	 rust,			master,  no,	"git@github.com:rust-lang/rust"
+Dev,   protobuf,          main,    no,     "git@github.com:protocolbuffers/protobuf"
-Tool,	 smartmontools,		master,  no,	"git@github.com:smartmontools/smartmontools"
+Dev,   rust,              master,  no,     "git@github.com:rust-lang/rust"
-Tool,	 talk2windows,		main,    no,	"git@github.com:fleschutz/talk2windows.git"
+Tool,  smartmontools,     master,  no,     "git@github.com:smartmontools/smartmontools"
-Tool,	 tensorflow,		master,  no,	"git@github.com:tensorflow/tensorflow"
+Tool,  talk2windows,      main,    no,     "git@github.com:fleschutz/talk2windows.git"
-Tool,	 terminal,		main,    no,	"git@github.com:microsoft/terminal"
+Tool,  tensorflow,        master,  no,     "git@github.com:tensorflow/tensorflow"
-Dev,	 tinycc,		mob,     no,	"git@github.com:TinyCC/tinycc"
+Tool,  terminal,          main,    no,     "git@github.com:microsoft/terminal"
-Tool,	 voice2json,		master,  no,	"git@github.com:synesthesiam/voice2json"
+Dev,   tinycc,            mob,     no,     "git@github.com:TinyCC/tinycc"
-Tool,	 zfs,			master,  no,	"git@github.com:openzfs/zfs"
+Tool,  voice2json,        master,  no,     "git@github.com:synesthesiam/voice2json"
+Tool,  zfs,               master,  no,     "git@github.com:openzfs/zfs"

Data/matrix.csv

@@ -1,29 +0,0 @@
-A,B,C,D,E,F,G,H,I,J,K,L,M,N,O,P,Q,R,S,T,U,V,W,X,Y,Z
-" ","P"," "," "," "," ","H"," "," "," ","R"," "," "," "," "," "," "," ","B"," "," "," "," "," ","M"
-" ","O"," "," "," "," ","A"," "," "," ","E"," "," "," "," "," "," "," ","L"," "," "," "," "," ","A"
-" ","W"," "," "," "," ","V"," "," "," ","D"," "," "," "," "," "," "," ","U"," "," "," "," "," ","T"
-" ","E"," "," "," "," ","E"," "," "," "," "," "," "," "," "," "," "," ","E"," "," "," "," "," ","R"
-" ","R"," "," "," "," "," "," "," "," ","P"," "," "," "," "," "," "," "," "," "," "," "," "," ","I"
-" ","S"," "," "," "," ","F"," "," "," ","I"," "," "," "," "," "," "," ","P"," "," "," "," "," ","X"
-" ","H"," "," "," "," ","U"," "," "," ","L"," "," "," "," "," "," "," ","I"," "," "," "," "," "," "
-" ","E"," "," "," "," ","N"," "," "," ","L"," "," "," "," "," "," "," ","L"," "," "," "," "," "," "
-" ","L"," "," "," "," "," "," "," "," ","?"," "," "," "," "," "," "," ","L"," "," "," "," "," "," "
-" ","L"," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," ","?"," "," "," "," "," "," "
-" "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "
-" ","R"," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "
-" ","U"," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "
-" ","L"," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "
-" ","E"," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "
-" ","S"," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "
-" "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "
-" "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "
-" "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "
-" "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "
-" "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "
-" "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "
-" "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "
-" "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "
-" "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "
-" "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "
-" "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "
-" "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "," "

Data/quotes.csv

@@ -1,32 +1,47 @@
-Genre,Author,Quote
+CATEGORY,AUTHOR,QUOTE
 IQ,Thomas Edison,"Genius is one percent inspiration and ninety-nine percent perspiration."
-Misc,Johann Wolfgang von Goethe,"Difficulties increase the nearer we get to the goal."
+Life,Abraham Lincoln,"In the end, it's not the years in your life that count. It's the life in your years."
-Misc,William Shakespeare,"Having nothing, nothing can he lose."
+Life,Albert Einstein,"Only a life lived for others is a life worthwhile."
+Life,Marilyn Monroe,"Keep smiling, because life is a beautiful thing and there's so much to smile about."
+Life,James M. Barrie,"Life is a long lesson in humility."
+Life,Bob Marley,"Love the life you live. Live the life you love."
+Life,Ray Bradbury,"Life is trying things to see if they work."
+Life,Helen Keller,"Life is either a daring adventure or nothing at all."
+Life,John Lennon,"Life is what happens when you're busy making other plans"
+Life,Jonathan Swift,"May you live all the days of your life."
+Misc,Abraham Lincoln,"The best thing about the future is that it only comes one day at a time."
 Misc,Albert Einstein,"Learn from yesterday, live for today, hope for tomorrow."
+Misc,Anne Frank,"Whoever is happy will make others happy too."
+Misc,Aristotle,"It is during our darkest moments that we must focus to see the light."
+Misc,Benjamin Franklin,"Tell me and I forget. Teach me and I remember. Involve me and I learn."
+Misc,Bruce Lee,"Mistakes are always forgivable, if one has the courage to admit them."
+Misc,Eleanor Roosevelt,"The future belongs to those who believe in the beauty of their dreams."
+Misc,Johann Wolfgang von Goethe,"Difficulties increase the nearer we get to the goal."
 Misc,Michelangelo,"Faith in oneself is the best and safest course."
 Misc,Sophocles,"It takes both sunshine and rain to make a rainbow."
 Misc,Mahatma Gandhi,"We must become the change we want to see."
 Misc,Johann Wolfgang von Goethe,"Knowing is not enough; we must apply!"
 Misc,Immanuel Kant,"Science is organized knowledge. Wisdom is organized life."
 Misc,Indira Gandhi,"You can't shake hands with a clenched fist."
-Misc,Albert Einstein,"Try not to become a man of success, but rather try to become a man of value."
 Misc,Pierre Auguste Renoir,"The pain passes, but the beauty remains."
 Misc,Heraclitus,"All is flux; nothing stays still."
 Misc,Japanese proverb,"The day you decide to do it is your lucky day."
-Misc,Abraham Lincoln,"The best thing about the future is that it only comes one day at a time."
 Misc,Epictetus,"We have two ears and one mouth so that we can listen twice as much as we speak."
 Misc,Cervantes,"Be slow of tongue and quick of eye."
-Misc,Bruce Lee,"Mistakes are always forgivable, if one has the courage to admit them."
 Misc,Nelson Mandela,"The greatest glory in living lies not in never falling, but in rising every time we fall."
-Misc,Walt Disney,"The way to get started is to quit talking and begin doing."
-Misc,John Lennon,"Life is what happens when you're busy making other plans"
 Misc,Mother Teresa,"Spread love everywhere you go. Let no one ever come to you without leaving happier."
-Misc,Benjamin Franklin,"Tell me and I forget. Teach me and I remember. Involve me and I learn."
-Misc,Aristotle,"It is during our darkest moments that we must focus to see the light."
-Misc,Anne Frank,"Whoever is happy will make others happy too."
-Misc,Helen Keller,"Life is either a daring adventure or nothing at all."
-Misc,Abraham Lincoln,"In the end, it's not the years in your life that count. It's the life in your years."
-Misc,Albert Einstein,"Only a life lived for others is a life worthwhile."
 Misc,Mae West,"You only live once, but if you do it right, once is enough."
-Misc,Jonathan Swift,"May you live all the days of your life."
 Misc,Hans Christian Andersen,"Life itself is the most wonderful fairy tale."
+Misc,Walt Disney,"The way to get started is to quit talking and begin doing."
+Misc,William Shakespeare,"Having nothing, nothing can he lose."
+Misc,Tony Robbins,"The only impossible journey is the one you never begin."
+Misc,Ralph Waldo Emerson,"Do not go where the path may lead, go instead where there is no path and leave a trail."
+Misc,Margaret Mead,"Always remember that you are absolutely unique. Just like everyone else."
+Success,Albert Einstein,"Try not to become a man of success, but rather try to become a man of value."
+Success,Steve Jobs,"If you really look closely, most overnight successes took a long time."
+Success,Oprah Winfrey,"You know you are on the road to success if you would do your job and not be paid for it."
+Success,David Brinkley,"A successful man is one who can lay a firm foundation with the bricks others have thrown at him."
+Success,Estee Lauder,"I never dreamed about success, I worked for it."
+Success,Henry David Thoreau,"Success usually comes to those who are too busy to be looking for it."
+Success,Colin Powell,"There are no secrets to success. It is the result of preparation, hard work, and learning from failure."
+Success,John D. Rockefeller,"The secret of success is to do the common thing uncommonly well."

Docs/FAQ.md

@@ -12,16 +12,16 @@ Why use PowerShell?
 
 ✔️ it's **cross-platform** - available for Linux, Mac OS and Windows
 
-✔️ it's **open-source and free** - see the Github repository at https://github.com/PowerShell/PowerShell 
+✔️ it's **open-source and free** - see the Github repository at: https://github.com/PowerShell/PowerShell 
 
-✔️ it's **easy to learn** - see the tutorial for beginners at https://www.guru99.com/powershell-tutorial.html
+✔️ it's **easy to learn** - see the tutorial for beginners at: https://www.guru99.com/powershell-tutorial.html
 
-✔️ it's **fully documented** - see the PowerShell documentation at https://docs.microsoft.com/en-us/powershell/
+✔️ it's **fully documented** - see the PowerShell documentation at: https://docs.microsoft.com/en-us/powershell/
 
 
-How to get PowerShell?
+How to install PowerShell?
-----------------------
+--------------------------
-* **On Windows** PowerShell is preinstalled. **However,** the default execution policy is "restricted", meaning script execution is disallowed! To change this, open the *Windows PowerShell (Administrator)* console and enter:
+* **On Windows** it's preinstalled. **However,** the execution policy is 'restricted' by default! To allow script execution: open the *Windows PowerShell (Administrator)* console and enter:
    ```
    PS> Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope CurrentUser
    ```
@@ -39,6 +39,16 @@ How to get the PowerShell Scripts?
 * **Otherwise,** download and unzip it from: https://github.com/fleschutz/PowerShell/archive/master.zip
 
 
+How to execute PowerShell Scripts?
+----------------------------------
+1. In the Windows desktop: right-click the script and select: *Execute with PowerShell*
+2. In a command-line interface (CLI, e.g. *Windows Terminal*, either local or remote via SSH) by typing: `./<FILENAME_OF_SCRIPT>`.
+3. By connecting a context menu item with a script.
+4. By voice control, e.g. see repo [talk2windows](https://github.com/fleschutz/talk2windows) for more information.
+5. By using automation software, e.g. [Jenkins](https://www.jenkins.io).
+6. Automatically on login (see AutoStart folder)/logoff/daily/etc.
+
+
 What about Security?
 --------------------
 * Execute scripts only that you trust (and/or where you have checked the code before)!
@@ -48,7 +58,7 @@ What about Security?
 
 Why do some scripts show gibberish characters?
 ----------------------------------------------
-Those PowerShell scripts are using Unicode characters. Use a modern console supporting UTF-8 such as Windows Terminal, please.
+Those PowerShell scripts are using Unicode characters. Use a modern console supporting UTF-8 such as *Windows Terminal*, please.
 
 
 How to set PowerShell as default shell on Linux?
@@ -83,11 +93,11 @@ Which editor to use for PowerShell scripts?
 
 How to write good PowerShell scripts?
 -------------------------------------
-Good PowerShell scripts are user-friendly and platform-independent. As a guideline follow these rules, please:
+Good PowerShell scripts are user-friendly and platform-independent. The following rules should be a good starting point:
 
 1. Use the `<verb>-<object>.ps1` scheme to name the script.
-2. Use *UTF-8 BOM* encoding to support Unicode characters in the script.
+2. Use `UTF-8 BOM` encoding to support Unicode characters in the script.
-3. Add a comment-based help at the beginning with synopsis, description, parameters, link, author, and license.
+3. Add a comment-based help at the beginning with: `.SYNOPSIS`, `.DESCRIPTION`, `.PARAMETER`, `.EXAMPLE`, `.LINK`, and `.NOTES`.
 4. Check the requirements for the script, e.g. `#Requires -RunAsAdministrator`, or `#Requires -Version 3`
 5. Prefer command-line options, else ask the user for help
 6. Recommended is `Set-StrictMode -Version Latest` to enable additional error checking.

Docs/add-firewall-rules.md

@@ -1,4 +1,4 @@
-## add-firewall-rules.ps1 - Adds firewall rules for executables (needs admin rights)
+## The *add-firewall-rules.ps1* Script
 
 This PowerShell script adds firewall rules for the given executable. Administrator rights are required.
 
@@ -30,9 +30,77 @@ Adding firewall rule for C:\MyApp\bin\app2.exe
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Adds firewall rules for executables (needs admin rights)
+.DESCRIPTION
+	This PowerShell script adds firewall rules for the given executable. Administrator rights are required.
+.PARAMETER PathToExecutables
+	Specifies the path to the executables
+.EXAMPLE
+	PS> ./add-firewall-rules C:\MyApp\bin
+	Adding firewall rule for C:\MyApp\bin\app1.exe
+	Adding firewall rule for C:\MyApp\bin\app2.exe
+	...
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+#Requires -RunAsAdministrator
+
+param([string]$PathToExecutables = "")
+
+$command = '
+$output = ''Firewall rules for path '' + $args[0]
+write-output $output
+for($i = 1; $i -lt $args.count; $i++){
+	$path = $args[0]
+	$path += ''\''
+	$path += $args[$i]
+
+	$null = $args[$i] -match ''[^\\]*\.exe$''
+	$name = $matches[0]
+    $output = ''Adding firewall rule for '' + $name
+	write-output $output
+	$null = New-NetFirewallRule -DisplayName $name -Direction Inbound -Program $path -Profile Domain, Private -Action Allow
+}
+write-host -foregroundColor green -noNewline ''Done - press any key to continue...'';
+[void]$Host.UI.RawUI.ReadKey(''NoEcho,IncludeKeyDown'');
+'
+
+
+try {
+	if ($PathToExecutables -eq "" ) {
+		$PathToExecutables = read-host "Enter path to executables"
+	}
+
+	$PathToExecutables = Convert-Path -Path $PathToExecutables
+
+	$Apps = Get-ChildItem "$PathToExecutables\*.exe" -Name
+
+	if($Apps.count -eq 0){
+		write-warning "No executables found. No Firewall rules have been created."
+		Write-Host -NoNewhLine 'Press any key to continue...';
+		[void]$Host.UI.RawUI.ReadKey('NoEcho,IncludeKeyDown');
+		exit 1
+	}
+
+	$arg = "PathToExecutables $Apps"
+	Start-Process powershell -Verb runAs -ArgumentList "-command & {$command}  $arg"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of add-firewall-rules.ps1*

Docs/add-memo.md

@@ -1,4 +1,4 @@
-## add-memo.ps1 - Adds a memo text
+## The *add-memo.ps1* Script
 
 This PowerShell script adds the given memo text to $HOME/Memos.csv.
 
@@ -28,9 +28,50 @@ PS> ./add-memo "Buy apples"
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Adds a memo text 
+.DESCRIPTION
+	This PowerShell script adds the given memo text to $HOME/Memos.csv.
+.PARAMETER text
+	Specifies the text to memorize
+.EXAMPLE
+	PS> ./add-memo "Buy apples"
+	✔️ added to 📄/home/markus/Memos.csv
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+param([string]$text = "")
+
+try {
+	if ($text -eq "" ) { $text = read-host "Enter the memo text to add" }
+
+	$Path = "$HOME/Memos.csv"
+	$Time = get-date -format "yyyy-MM-ddTHH:mm:ssZ" -asUTC
+	$User = $(whoami)
+	$Line = "$Time,$User,$text"
+
+	if (-not(test-path "$Path" -pathType leaf)) {
+		write-output "Time,User,text" > "$Path"
+	}
+	write-output $Line >> "$Path"
+
+	"✔️ added to 📄$Path"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of add-memo.ps1*

Docs/alert.md

@@ -1,4 +1,4 @@
-## alert.ps1 - Handles and escalates an alert
+## The *alert.ps1* Script
 
 This PowerShell script handles and escalates the given alert message.
 
@@ -27,9 +27,42 @@ PS> ./alert "Harddisk failure"
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Handles and escalates an alert 
+.DESCRIPTION
+	This PowerShell script handles and escalates the given alert message.
+.PARAMETER message
+	Specifies the alert message
+.EXAMPLE
+	PS> ./alert "Harddisk failure"
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+param([string]$Message = "")
+
+try {
+	if ($Message -eq "" ) { $URL = read-host "Enter alert message" }
+
+	echo "ALERT: $Message"
+
+	curl --header "Access-Token: o.PZl5XCp6SBl4F5PpaNXGDfFpUJZKAlEb" --header "Content-Type: application/json" --data-binary '{"type": "note", "title": "ALERT", "body": "$Message"}' --request POST https://api.pushbullet.com/v2/pushes
+
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of alert.ps1*

Docs/build-repo.md

@@ -1,4 +1,4 @@
-## build-repo.ps1 - Builds a Git repository
+## The *build-repo.ps1* Script
 
 This PowerShell script supports building with cmake, configure, autogen, Imakefile and Makefile.
 
@@ -27,9 +27,141 @@ PS> ./build-repo C:\MyRepo
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Builds a Git repository 
+.DESCRIPTION
+	This PowerShell script supports building with cmake, configure, autogen, Imakefile and Makefile.
+.PARAMETER RepoDir
+	Specifies the path to the Git repository
+.EXAMPLE
+	PS> ./build-repo C:\MyRepo
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+param([string]$RepoDir = "$PWD")
+
+function MakeDir { param($Path)
+	$DirName = (get-item "$Path").Name
+	if (test-path "$Path/CMakeLists.txt" -pathType leaf) {
+		"🔨 Building 📂$DirName using CMakeLists.txt to subfolder _My_Build/..."
+		if (-not(test-path "$Path/_My_Build/" -pathType container)) { 
+			& mkdir "$Path/_My_Build/"
+		}
+		set-location "$Path/_My_Build/"
+
+		& cmake ..
+		if ($lastExitCode -ne "0") { throw "Executing 'cmake ..' has failed" }
+
+		& make -j4
+		if ($lastExitCode -ne "0") { throw "Executing 'make -j4' has failed" }
+
+		& make test
+		if ($lastExitCode -ne "0") { throw "Executing 'make test' has failed" }
+
+	} elseif (test-path "$Path/configure" -pathType leaf) { 
+		"🔨 Building 📂$DirName using 'configure'..."
+		set-location "$Path/"
+
+		& ./configure
+		#if ($lastExitCode -ne "0") { throw "Script 'configure' exited with error code $lastExitCode" }
+
+		& make -j4
+		if ($lastExitCode -ne "0") { throw "Executing 'make -j4' has failed" }
+
+		& make test
+		if ($lastExitCode -ne "0") { throw "Executing 'make test' has failed" }
+
+	} elseif (test-path "$Path/autogen.sh" -pathType leaf) { 
+		"🔨 Building 📂$DirName using 'autogen.sh'..."
+		set-location "$Path/"
+
+		& ./autogen.sh
+		if ($lastExitCode -ne "0") { throw "Script 'autogen.sh' exited with error code $lastExitCode" }
+
+		& make -j4
+		if ($lastExitCode -ne "0") { throw "Executing 'make -j4' has failed" }
+
+	} elseif (test-path "$Path/build.gradle" -pathType leaf) {
+		"🔨 Building 📂$DirName using build.gradle..."
+		set-location "$Path"
+
+		& gradle build
+		if ($lastExitCode -ne "0") { throw "'gradle build' has failed" }
+
+		& gradle test
+		if ($lastExitCode -ne "0") { throw "'gradle test' has failed" }
+
+	} elseif (test-path "$Path/Imakefile" -pathType leaf) {
+		"🔨 Building 📂$DirName using Imakefile..."
+		set-location "$RepoDir/"
+
+		& xmkmf 
+		if ($lastExitCode -ne "0") { throw "Executing 'xmkmf' has failed" }
+
+		& make -j4
+		if ($lastExitCode -ne "0") { throw "Executing 'make -j4' has failed" }
+
+	} elseif (test-path "$Path/Makefile" -pathType leaf) {
+		"🔨 Building 📂$DirName using Makefile..."
+		set-location "$Path"
+
+		& make -j4
+		if ($lastExitCode -ne "0") { throw "Executing 'make -j4' has failed" }
+
+	} elseif (test-path "$Path/compile.sh" -pathType leaf) { 
+		"🔨 Building 📂$DirName using 'compile.sh'..."
+		set-location "$Path/"
+
+		& ./compile.sh
+		if ($lastExitCode -ne "0") { throw "Script 'compile.sh' exited with error code $lastExitCode" }
+
+		& make -j4
+		if ($lastExitCode -ne "0") { throw "Executing 'make -j4' has failed" }
+
+	} elseif (test-path "$Path/attower/src/build/DevBuild/build.bat" -pathType leaf) {
+		"🔨 Building 📂$DirName using build.bat ..."
+		set-location "$Path/attower/src/build/DevBuild/"
+
+		& ./build.bat build-all-release
+		if ($lastExitCode -ne "0") { throw "Script 'build.bat' exited with error code $lastExitCode" }
+
+	} elseif (test-path "$Path/$DirName" -pathType container) {
+		"🔨 No make rule found, trying subfolder 📂$($DirName)..."
+		MakeDir "$Path/$DirName"
+	} else {
+		write-warning "Sorry, no make rule applies to: 📂$DirName"
+		exit 0 # success
+	}
+}
+
+try {
+	$StopWatch = [system.diagnostics.stopwatch]::startNew()
+
+	if (-not(test-path "$RepoDir" -pathType container)) { throw "Can't access directory: $RepoDir" }
+	$RepoDirName = (get-item "$RepoDir").Name
+
+	$PreviousPath = get-location
+	MakeDir "$RepoDir"
+	set-location "$PreviousPath"
+
+	[int]$Elapsed = $StopWatch.Elapsed.TotalSeconds
+	"✔️ built Git repository 📂$RepoDirName in $Elapsed sec"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of build-repo.ps1*

Docs/build-repos.md

@@ -1,13 +1,13 @@
-## build-repos.ps1 - Builds all Git repositories in a folder
+## The *build-repos.ps1* Script
 
-This PowerShell script builds all Git repositories in a given folder.
+This PowerShell script builds all Git repositories in a folder.
 
 ## Parameters
 ```powershell
 build-repos.ps1 [[-ParentDir] <String>] [<CommonParameters>]
 
 -ParentDir <String>
-    Specifies the path to the folder containing the Git repositories
+    Specifies the path to the parent folder
     
     Required?                    false
     Position?                    1
@@ -27,9 +27,53 @@ PS> ./build-repos C:\MyRepos
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Builds Git repositories
+.DESCRIPTION
+	This PowerShell script builds all Git repositories in a folder.
+.PARAMETER ParentDir
+	Specifies the path to the parent folder
+.EXAMPLE
+	PS> ./build-repos C:\MyRepos
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+param([string]$ParentDir = "$PWD")
+
+try {
+	$StopWatch = [system.diagnostics.stopwatch]::startNew()
+
+	$ParentDirName = (Get-Item "$ParentDir").Name
+	"⏳ Step 1 - Checking parent folder 📂$ParentDirName..."
+	if (-not(Test-Path "$ParentDir" -pathType container)) { throw "Can't access folder: $ParentDir" }
+	$Folders = (Get-ChildItem "$ParentDir" -attributes Directory)
+	$FolderCount = $Folders.Count
+	"Found $FolderCount subfolders."
+
+	[int]$Step = 1
+	foreach ($Folder in $Folders) {
+		& "$PSScriptRoot/build-repo.ps1" "$Folder"
+		$Step++
+	}
+
+	[int]$Elapsed = $StopWatch.Elapsed.TotalSeconds
+	"✔️ built $FolderCount Git repositories at 📂$ParentDirName in $Elapsed sec"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of build-repos.ps1*

Docs/cd-autostart.md

@@ -1,4 +1,4 @@
-## cd-autostart.ps1 - Sets the working directory to the user's autostart folder
+## The *cd-autostart.ps1* Script
 
 This PowerShell script changes the working directory to the user's autostart folder.
 
@@ -19,9 +19,39 @@ PS> ./cd-autostart
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Sets the working directory to the user's autostart folder
+.DESCRIPTION
+	This PowerShell script changes the working directory to the user's autostart folder.
+.EXAMPLE
+	PS> ./cd-autostart
+	📂C:\Users\Markus\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	$Path = Resolve-Path "$HOME/AppData/Roaming/Microsoft/Windows/Start Menu/Programs/Startup"
+	if (-not(Test-Path "$Path" -pathType container)) {
+		throw "Autostart folder at 📂$Path doesn't exist (yet)"
+	}
+	Set-Location "$Path"
+	"📂$Path"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of cd-autostart.ps1*

Docs/cd-desktop.md

@@ -1,4 +1,4 @@
-## cd-desktop.ps1 - Sets the working directory to the user's desktop folder
+## The *cd-desktop.ps1* Script
 
 This PowerShell script changes the working directory to the user's desktop folder.
 
@@ -14,14 +14,48 @@ cd-desktop.ps1 [<CommonParameters>]
 ## Example
 ```powershell
 PS> ./cd-desktop
-📂/home/markus/Desktop
+📂/home/Markus/Desktop
 
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Sets the working directory to the user's desktop folder
+.DESCRIPTION
+	This PowerShell script changes the working directory to the user's desktop folder.
+.EXAMPLE
+	PS> ./cd-desktop
+	📂/home/Markus/Desktop
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	if ($IsLinux) {
+		$Path = Resolve-Path "$HOME/Desktop"
+	} else {
+		$Path = [Environment]::GetFolderPath('DesktopDirectory')
+	}
+	if (-not(Test-Path "$Path" -pathType container)) {
+		throw "Desktop folder at 📂$Path doesn't exist (yet)"
+	}
+	Set-Location "$Path"
+	"📂$Path"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of cd-desktop.ps1*

Docs/cd-docs.md

@@ -1,6 +1,6 @@
-## cd-docs.ps1 - Sets the working directory to the user's documents folder
+## The *cd-docs.ps1* Script
 
-This PowerShell script changes the working directory to the user's documents folder.
+This PowerShell script changes the working directory to the documents folder.
 
 ## Parameters
 ```powershell
@@ -14,14 +14,48 @@ cd-docs.ps1 [<CommonParameters>]
 ## Example
 ```powershell
 PS> ./cd-docs
-📂/home/markus/Documents
+📂C:\Users\Markus\Documents
 
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Sets the working directory to the documents folder
+.DESCRIPTION
+	This PowerShell script changes the working directory to the documents folder.
+.EXAMPLE
+	PS> ./cd-docs
+	📂C:\Users\Markus\Documents
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	if ($IsLinux) {
+		$Path = Resolve-Path "$HOME/Documents"
+	} else {
+		$Path = [Environment]::GetFolderPath('MyDocuments')
+	}
+	if (-not(Test-Path "$Path" -pathType container)) {
+		throw "Documents folder at 📂$Path doesn't exist (yet)"
+	}
+	Set-Location "$Path"
+	"📂$Path"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of cd-docs.ps1*

Docs/cd-downloads.md

@@ -1,4 +1,4 @@
-## cd-downloads.ps1 - Sets the working directory to the user's downloads folder
+## The *cd-downloads.ps1* Script
 
 This PowerShell script changes the working directory to the user's downloads folder.
 
@@ -14,14 +14,48 @@ cd-downloads.ps1 [<CommonParameters>]
 ## Example
 ```powershell
 PS> ./cd-downloads
-📂/home/markus/Downloads
+📂C:\Users\Markus\Downloads
 
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Sets the working directory to the user's downloads folder
+.DESCRIPTION
+	This PowerShell script changes the working directory to the user's downloads folder.
+.EXAMPLE
+	PS> ./cd-downloads
+	📂C:\Users\Markus\Downloads
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	if ($IsLinux) {
+		$Path = Resolve-Path "$HOME/Downloads"
+	} else {
+		$Path = (New-Object -ComObject Shell.Application).NameSpace('shell:Downloads').Self.Path
+	}
+	if (-not(Test-Path "$Path" -pathType container)) {
+		throw "Downloads folder at 📂$Path doesn't exist (yet)"
+	}
+	Set-Location "$Path"
+	"📂$Path"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of cd-downloads.ps1*

Docs/cd-dropbox.md

@@ -1,4 +1,4 @@
-## cd-dropbox.ps1 - Sets the working directory to the user's Dropbox folder
+## The *cd-dropbox.ps1* Script
 
 This PowerShell script changes the working directory to the user's Dropbox folder.
 
@@ -14,14 +14,44 @@ cd-dropbox.ps1 [<CommonParameters>]
 ## Example
 ```powershell
 PS> ./cd-dropbox
-📂/home/markus/Dropbox
+📂/home/Markus/Dropbox
 
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Sets the working directory to the user's Dropbox folder
+.DESCRIPTION
+	This PowerShell script changes the working directory to the user's Dropbox folder.
+.EXAMPLE
+	PS> ./cd-dropbox
+	📂/home/Markus/Dropbox
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	$Path = Resolve-Path "$HOME/Dropbox"
+	if (-not(Test-Path "$Path" -pathType container)) {
+		throw "Dropbox folder at 📂$Path doesn't exist (yet)"
+	}
+	Set-Location "$Path"
+	"📂$Path"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of cd-dropbox.ps1*

Docs/cd-fonts.md

@@ -0,0 +1,57 @@
+## The *cd-fonts.ps1* Script
+
+This PowerShell script changes the working directory to the fonts folder.
+
+## Parameters
+```powershell
+cd-fonts.ps1 [<CommonParameters>]
+
+[<CommonParameters>]
+    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
+    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
+```
+
+## Example
+```powershell
+PS> ./cd-fonts
+📂C:\Windows\Fonts
+
+```
+
+## Notes
+Author: Markus Fleschutz | License: CC0
+
+## Related Links
+https://github.com/fleschutz/PowerShell
+
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Sets the working directory to the fonts folder
+.DESCRIPTION
+	This PowerShell script changes the working directory to the fonts folder.
+.EXAMPLE
+	PS> ./cd-fonts
+	📂C:\Windows\Fonts
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	$Path = [Environment]::GetFolderPath('Fonts')
+	if (-not(Test-Path "$Path" -pathType container)) {
+		throw "Fonts folder at 📂$Path doesn't exist (yet)"
+	}
+	Set-Location "$Path"
+	"📂$Path"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
+*Generated by convert-ps2md.ps1 using the comment-based help of cd-fonts.ps1*

Docs/cd-home.md

@@ -1,4 +1,4 @@
-## cd-home.ps1 - Sets the working directory to the user's home directory
+## The *cd-home.ps1* Script
 
 This PowerShell script changes the working directory to the user's home directory.
 
@@ -14,14 +14,44 @@ cd-home.ps1 [<CommonParameters>]
 ## Example
 ```powershell
 PS> ./cd-home
-📂/home/markus
+📂/home/Markus
 
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Sets the working directory to the user's home directory
+.DESCRIPTION
+	This PowerShell script changes the working directory to the user's home directory.
+.EXAMPLE
+	PS> ./cd-home
+	📂/home/Markus
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	$Path = Resolve-Path "$HOME"
+	if (-not(Test-Path "$Path" -pathType container)) {
+		throw "Home directory at 📂$Path doesn't exist (yet)"
+	}
+	Set-Location "$Path"
+	"📂$Path"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of cd-home.ps1*

Docs/cd-music.md

@@ -1,4 +1,4 @@
-## cd-music.ps1 - Sets the working directory to the user's music folder
+## The *cd-music.ps1* Script
 
 This PowerShell script changes the working directory to the user's music folder.
 
@@ -14,14 +14,48 @@ cd-music.ps1 [<CommonParameters>]
 ## Example
 ```powershell
 PS> ./cd-music
-📂/home/markus/Music
+📂/home/Markus/Music
 
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Sets the working directory to the user's music folder
+.DESCRIPTION
+	This PowerShell script changes the working directory to the user's music folder.
+.EXAMPLE
+	PS> ./cd-music
+	📂/home/Markus/Music
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	if ($IsLinux) {
+		$Path = Resolve-Path "$HOME/Music"
+	} else {
+		$Path = [Environment]::GetFolderPath('MyMusic')
+	}
+	if (-not(Test-Path "$Path" -pathType container)) {
+		throw "Music folder at 📂$Path doesn't exist (yet)"
+	}
+	Set-Location "$Path"
+	"📂$Path"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of cd-music.ps1*

Docs/cd-onedrive.md

@@ -1,4 +1,4 @@
-## cd-onedrive.ps1 - Sets the working directory to the user's OneDrive folder
+## The *cd-onedrive.ps1* Script
 
 This PowerShell script changes the working directory to the user's OneDrive folder.
 
@@ -14,14 +14,44 @@ cd-onedrive.ps1 [<CommonParameters>]
 ## Example
 ```powershell
 PS> ./cd-onedrive
-📂/home/markus/OneDrive
+📂/home/Markus/OneDrive
 
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Sets the working directory to the user's OneDrive folder
+.DESCRIPTION
+	This PowerShell script changes the working directory to the user's OneDrive folder.
+.EXAMPLE
+	PS> ./cd-onedrive
+	📂/home/Markus/OneDrive
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	$Path = Resolve-Path "$HOME/OneDrive"
+	if (-not(Test-Path "$Path" -pathType container)) {
+		throw "OneDrive folder at 📂$Path doesn't exist (yet)"
+	}
+	Set-Location "$Path"
+	"📂$Path"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of cd-onedrive.ps1*

Docs/cd-pics.md

@@ -1,4 +1,4 @@
-## cd-pics.ps1 - Sets the working directory to the user's pictures folder
+## The *cd-pics.ps1* Script
 
 This PowerShell script changes the working directory to the user's pictures folder.
 
@@ -14,14 +14,48 @@ cd-pics.ps1 [<CommonParameters>]
 ## Example
 ```powershell
 PS> ./cd-pics
-📂/home/markus/Pictures
+📂/home/Markus/Pictures
 
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Sets the working directory to the user's pictures folder
+.DESCRIPTION
+	This PowerShell script changes the working directory to the user's pictures folder.
+.EXAMPLE
+	PS> ./cd-pics
+	📂/home/Markus/Pictures
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	if ($IsLinux) {
+		$Path = Resolve-Path "$HOME/Pictures"
+	} else {
+		$Path = [Environment]::GetFolderPath('MyPictures')
+	}
+	if (-not(Test-Path "$Path" -pathType container)) {
+		throw "Pictures folder at 📂$Path doesn't exist (yet)"
+	}
+	Set-Location "$Path"
+	"📂$Path"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of cd-pics.ps1*

Docs/cd-recycle-bin.md

@@ -1,4 +1,6 @@
-## cd-recycle-bin.ps1 - cd-recycle-bin.ps1 
+## The *cd-recycle-bin.ps1* Script
+
+cd-recycle-bin.ps1 
 
 
 ## Parameters
@@ -10,4 +12,40 @@
     WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
 ```
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Sets the working directory to the user's recycle bin folder
+.DESCRIPTION
+	This PowerShell script changes the working directory to the user's recycle bin folder.
+.EXAMPLE
+	PS> ./cd-recycle-bin
+	📂C:\$Recycle.Bin\S-1-5-21-123404-23309-294260-1001
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+function GetCurrentUserSID { [CmdletBinding()] param()
+	Add-Type -AssemblyName System.DirectoryServices.AccountManagement
+	return ([System.DirectoryServices.AccountManagement.UserPrincipal]::Current).SID.Value
+}
+
+
+try {
+	$Path = 'C:\$Recycle.Bin\' + "$(GetCurrentUserSID)"
+	if (-not(Test-Path "$Path" -pathType container)) {
+		throw "Recycle bin folder at 📂$Path doesn't exist (yet)"
+	}
+	Set-Location "$Path"
+	"📂$Path"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of cd-recycle-bin.ps1*

Docs/cd-repos.md

@@ -1,10 +1,19 @@
-## cd-repos.ps1 - Sets the working directory to the user's Git repositories folder
+## The *cd-repos.ps1* Script
 
 This PowerShell script changes the working directory to the user's Git repositories folder.
 
 ## Parameters
 ```powershell
-cd-repos.ps1 [<CommonParameters>]
+cd-repos.ps1 [[-Subpath] <String>] [<CommonParameters>]
+
+-Subpath <String>
+    Specifies an additional relative subpath (optional)
+    
+    Required?                    false
+    Position?                    1
+    Default value                
+    Accept pipeline input?       false
+    Accept wildcard characters?  false
 
 [<CommonParameters>]
     This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
@@ -14,14 +23,57 @@ cd-repos.ps1 [<CommonParameters>]
 ## Example
 ```powershell
 PS> ./cd-repos
-📂/home/markus/Repos
+📂C:\Users\Markus\Repos
 
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Sets the working directory to the user's repos folder
+.DESCRIPTION
+	This PowerShell script changes the working directory to the user's Git repositories folder.
+.PARAMETER Subpath
+	Specifies an additional relative subpath (optional)
+.EXAMPLE
+	PS> ./cd-repos
+	📂C:\Users\Markus\Repos
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+param([string]$Subpath = "")
+
+try {
+	if (Test-Path "$HOME/Repos" -pathType Container) {		# try short name
+		$Path = "$HOME/Repos/$Subpath"
+	} elseif (Test-Path "$HOME/Repositories" -pathType Container) {	# try long name
+		$Path = "$HOME/Repositories/$Subpath"
+	} elseif (Test-Path "$HOME/source/repos" -pathType Container) { # try Visual Studio default
+		$Path = "$HOME/source/repos/$Subpath"
+	} else {
+		throw "The folder for Git repositories at 📂$HOME/Reposh doesn't exist (yet)."
+	}
+	if (-not(Test-Path "$Path" -pathType Container)) {
+		throw "The path to 📂$Path doesn't exist (yet)."
+	}
+	$Path = Resolve-Path "$Path"
+	Set-Location "$Path"
+	"📂$Path"
+	exit 0 # success
+} catch {
+	"⚠️ Error: $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of cd-repos.ps1*

Docs/cd-root.md

@@ -1,6 +1,6 @@
-## cd-root.ps1 - Sets the working directory to the root directory
+## The *cd-root.ps1* Script
 
-This PowerShell script changes the working directory to the root directory (C:\ on Windows).
+This PowerShell script changes the current working directory to the root directory (C:\ on Windows).
 
 ## Parameters
 ```powershell
@@ -19,9 +19,36 @@ PS> ./cd-root
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Sets the working directory to the root directory 
+.DESCRIPTION
+	This PowerShell script changes the current working directory to the root directory (C:\ on Windows).
+.EXAMPLE
+	PS> ./cd-root
+	📂C:\
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	if ($IsLinux) {	$Path = "/" } else { $Path = "C:\" }
+	Set-Location "$Path"
+	"📂$Path"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of cd-root.ps1*

Docs/cd-screenshots.md

@@ -0,0 +1,62 @@
+## The *cd-screenshots.ps1* Script
+
+This PowerShell script changes the working directory to the user's screenshots folder.
+
+## Parameters
+```powershell
+cd-screenshots.ps1 [<CommonParameters>]
+
+[<CommonParameters>]
+    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
+    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
+```
+
+## Example
+```powershell
+PS> ./cd-screenshots
+📂C:\Users\Markus\Pictures\Screenshots
+
+```
+
+## Notes
+Author: Markus Fleschutz | License: CC0
+
+## Related Links
+https://github.com/fleschutz/PowerShell
+
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Sets the working directory to the user's screenshots folder
+.DESCRIPTION
+	This PowerShell script changes the working directory to the user's screenshots folder.
+.EXAMPLE
+	PS> ./cd-screenshots
+	📂C:\Users\Markus\Pictures\Screenshots
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	if ($IsLinux) {
+		$Path = Resolve-Path "$HOME/Pictures/Screenshots"
+	} else {
+		$Path = [Environment]::GetFolderPath('MyPictures')
+		$Path = "$Path\Screenshots"
+	}
+	if (-not(Test-Path "$Path" -pathType container)) {
+		throw "Screenshots folder at 📂$Path doesn't exist (yet)"
+	}
+	Set-Location "$Path"
+	"📂$Path"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
+*Generated by convert-ps2md.ps1 using the comment-based help of cd-screenshots.ps1*

Docs/cd-scripts.md

@@ -1,4 +1,4 @@
-## cd-scripts.ps1 - Sets the working directory to the PowerShell scripts folder
+## The *cd-scripts.ps1* Script
 
 This PowerShell script changes the working directory to the PowerShell scripts folder.
 
@@ -14,14 +14,44 @@ cd-scripts.ps1 [<CommonParameters>]
 ## Example
 ```powershell
 PS> ./cd-scripts
-📂/home/markus/PowerShell/Scripts
+📂/home/Markus/PowerShell/Scripts
 
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Sets the working directory to the PowerShell scripts folder
+.DESCRIPTION
+	This PowerShell script changes the working directory to the PowerShell scripts folder.
+.EXAMPLE
+	PS> ./cd-scripts
+	📂/home/Markus/PowerShell/Scripts
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	$Path = Resolve-Path "$PSScriptRoot"
+	if (-not(Test-Path "$Path" -pathType container)) {
+		throw "PowerShell scripts folder at 📂$Path doesn't exist (yet)"
+	}
+	Set-Location "$Path"
+	"📂$Path"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of cd-scripts.ps1*

Docs/cd-ssh.md

@@ -1,4 +1,4 @@
-## cd-ssh.ps1 - Sets the working directory to the user's SSH folder
+## The *cd-ssh.ps1* Script
 
 This PowerShell script changes the working directory to the user's SSH folder.
 
@@ -14,14 +14,44 @@ cd-ssh.ps1 [<CommonParameters>]
 ## Example
 ```powershell
 PS> ./cd-ssh
-📂/home/markus/.ssh
+📂/home/Markus/.ssh
 
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Sets the working directory to the user's SSH folder
+.DESCRIPTION
+	This PowerShell script changes the working directory to the user's SSH folder.
+.EXAMPLE
+	PS> ./cd-ssh
+	📂/home/Markus/.ssh
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	$Path = Resolve-Path "$HOME/.ssh"
+	if (-not(Test-Path "$Path" -pathType container)) {
+		throw "SSH folder at 📂$Path doesn't exist (yet)"
+	}
+	Set-Location "$Path"
+	"📂$Path"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of cd-ssh.ps1*

Docs/cd-temp.md

@@ -1,4 +1,6 @@
-## cd-temp.ps1 - cd-temp.ps1 
+## The *cd-temp.ps1* Script
+
+cd-temp.ps1 
 
 
 ## Parameters
@@ -10,4 +12,41 @@
     WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
 ```
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Sets the working directory to the temporary folder
+.DESCRIPTION
+	This PowerShell script changes the working directory to the temporary folder.
+.EXAMPLE
+	PS> ./cd-temp
+	📂C:\Users\Markus\AppData\Local\Temp
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+function GetTempDir {
+        if ("$env:TEMP" -ne "") { return "$env:TEMP" }
+        if ("$env:TMP" -ne "")  { return "$env:TMP" }
+        if ($IsLinux) { return "/tmp" }
+        return "C:\Temp"
+}
+
+try {
+	$Path = GetTempDir
+	if (-not(Test-Path "$Path" -pathType container)) {
+		throw "Temporary folder at 📂$Path doesn't exist (yet)"
+	}
+	Set-Location "$Path"
+	"📂$Path"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of cd-temp.ps1*

Docs/cd-up.md

@@ -1,4 +1,4 @@
-## cd-up.ps1 - Sets the working directory to one level up
+## The *cd-up.ps1* Script
 
 This PowerShell script changes the working directory to one directory level up.
 
@@ -14,13 +14,44 @@ cd-up.ps1 [<CommonParameters>]
 ## Example
 ```powershell
 PS> .\cd-up
+📂C:\Users
 
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Sets the working directory to one level up
+.DESCRIPTION
+	This PowerShell script changes the working directory to one directory level up.
+.EXAMPLE
+	PS> .\cd-up
+	📂C:\Users
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	$Path = Resolve-Path ".."
+	if (-not(Test-Path "$Path" -pathType container)) {
+		throw "Folder at 📂$Path doesn't exist (yet)"
+	}
+	Set-Location "$Path"
+	"📂$Path"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of cd-up.ps1*

Docs/cd-up2.md

@@ -1,4 +1,4 @@
-## cd-up2.ps1 - Sets the working directory to two directory levels up
+## The *cd-up2.ps1* Script
 
 This PowerShell script changes the working directory to two directory level up.
 
@@ -14,13 +14,44 @@ cd-up2.ps1 [<CommonParameters>]
 ## Example
 ```powershell
 PS> ./cd-up2
+📂C:\
 
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Sets the working directory to two directory levels up
+.DESCRIPTION
+	This PowerShell script changes the working directory to two directory level up.
+.EXAMPLE
+	PS> ./cd-up2
+	📂C:\
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	$Path = Resolve-Path "../.."
+	if (-not(Test-Path "$Path" -pathType container)) {
+		throw "Folder at 📂$Path doesn't exist (yet)"
+	}
+	Set-Location "$Path"
+	"📂$Path"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of cd-up2.ps1*

Docs/cd-up3.md

@@ -1,4 +1,4 @@
-## cd-up3.ps1 - Sets the working directory to three directory levels up
+## The *cd-up3.ps1* Script
 
 This PowerShell script changes the working directory to three directory levels up.
 
@@ -14,13 +14,44 @@ cd-up3.ps1 [<CommonParameters>]
 ## Example
 ```powershell
 PS> ./cd-up3
+📂C:\
 
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Sets the working directory to three directory levels up
+.DESCRIPTION
+	This PowerShell script changes the working directory to three directory levels up.
+.EXAMPLE
+	PS> ./cd-up3
+	📂C:\
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	$Path = Resolve-Path "../../.."
+	if (-not(Test-Path "$Path" -pathType container)) {
+		throw "Folder at 📂$Path doesn't exist (yet)"
+	}
+	Set-Location "$Path"
+	"📂$Path"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of cd-up3.ps1*

Docs/cd-up4.md

@@ -1,4 +1,4 @@
-## cd-up4.ps1 - Sets the working directory to four directory levels up
+## The *cd-up4.ps1* Script
 
 This PowerShell script changes the working directory to four directory levels up.
 
@@ -14,13 +14,44 @@ cd-up4.ps1 [<CommonParameters>]
 ## Example
 ```powershell
 PS> ./cd-up4
+📂C:\
 
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Sets the working directory to four directory levels up
+.DESCRIPTION
+	This PowerShell script changes the working directory to four directory levels up.
+.EXAMPLE
+	PS> ./cd-up4
+	📂C:\
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	$Path = Resolve-Path "../../../.."
+	if (-not(Test-Path "$Path" -pathType container)) {
+		throw "Folder at 📂$Path doesn't exist (yet)"
+	}
+	Set-Location "$Path"
+	"📂$Path"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of cd-up4.ps1*

Docs/cd-users.md

@@ -0,0 +1,57 @@
+## The *cd-users.ps1* Script
+
+This PowerShell script changes the working directory to the users directory.
+
+## Parameters
+```powershell
+cd-users.ps1 [<CommonParameters>]
+
+[<CommonParameters>]
+    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
+    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
+```
+
+## Example
+```powershell
+PS> ./cd-users
+📂C:\Users
+
+```
+
+## Notes
+Author: Markus Fleschutz | License: CC0
+
+## Related Links
+https://github.com/fleschutz/PowerShell
+
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Sets the working directory to the users directory
+.DESCRIPTION
+	This PowerShell script changes the working directory to the users directory.
+.EXAMPLE
+	PS> ./cd-users
+	📂C:\Users
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	$Path = Resolve-Path "$HOME/.."
+	if (-not(Test-Path "$Path" -pathType container)) {
+		throw "Users directory at 📂$Path doesn't exist (yet)"
+	}
+	Set-Location "$Path"
+	"📂$Path"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
+*Generated by convert-ps2md.ps1 using the comment-based help of cd-users.ps1*

Docs/cd-videos.md

@@ -1,4 +1,4 @@
-## cd-videos.ps1 - Sets the working directory to the user's videos folder
+## The *cd-videos.ps1* Script
 
 This PowerShell script changes the working directory to the user's videos folder.
 
@@ -14,14 +14,48 @@ cd-videos.ps1 [<CommonParameters>]
 ## Example
 ```powershell
 PS> ./cd-videos
-📂/home/markus/Videos
+📂C:\Users\Markus\Videos
 
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Sets the working directory to the user's videos folder
+.DESCRIPTION
+	This PowerShell script changes the working directory to the user's videos folder.
+.EXAMPLE
+	PS> ./cd-videos
+	📂C:\Users\Markus\Videos
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	if ($IsLinux) {
+		$Path = Resolve-Path "$HOME/Videos"
+	} else {
+		$Path = [Environment]::GetFolderPath('MyVideos')
+	}
+	if (-not(Test-Path "$Path" -pathType container)) {
+		throw "Videos folder at 📂$Path doesn't exist (yet)"
+	}
+	Set-Location "$Path"
+	"📂$Path"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of cd-videos.ps1*

Docs/cd-windows.md

@@ -1,4 +1,4 @@
-## cd-windows.ps1 - Sets the working directory to the Windows directory
+## The *cd-windows.ps1* Script
 
 This PowerShell script changes the working directory to the Windows directory.
 
@@ -19,9 +19,39 @@ PS> ./cd-windows
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Sets the working directory to the Windows directory
+.DESCRIPTION
+	This PowerShell script changes the working directory to the Windows directory.
+.EXAMPLE
+	PS> ./cd-windows
+	📂C:\Windows
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	$Path = Resolve-Path "$env:WINDIR"
+	if (-not(Test-Path "$Path" -pathType container)) {
+		throw "Windows directory at 📂$Path doesn't exist"
+	}
+	Set-Location "$Path"
+	"📂$Path"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of cd-windows.ps1*

Docs/change-wallpaper.md

@@ -1,4 +1,4 @@
-## change-wallpaper.ps1 - Changes the wallpaper
+## The *change-wallpaper.ps1* Script
 
 This PowerShell script downloads a random photo from Unsplash and sets it as desktop background.
 
@@ -27,9 +27,50 @@ PS> ./change-wallpaper
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Changes the wallpaper
+.DESCRIPTION
+	This PowerShell script downloads a random photo from Unsplash and sets it as desktop background.
+.PARAMETER Category
+	Specifies the photo category (beach, city, ...)
+.EXAMPLE
+	PS> ./change-wallpaper 
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+param([string]$Category = "")
+
+function GetTempDir {
+        if ("$env:TEMP" -ne "") { return "$env:TEMP" }
+        if ("$env:TMP" -ne "")  { return "$env:TMP" }
+        if ($IsLinux) { return "/tmp" }
+        return "C:\Temp"
+}
+
+try {
+	& "$PSScriptRoot/speak-english.ps1" "Just a second..."
+
+	$Path = "$(GetTempDir)/next_wallpaper.jpg"
+	& wget -O $Path "https://source.unsplash.com/3840x2160?$Category"
+	if ($lastExitCode -ne "0") { throw "Download failed" }
+
+	& "$PSScriptRoot/set-wallpaper.ps1" -ImageFile "$Path"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of change-wallpaper.ps1*

Docs/check-apps.md

@@ -0,0 +1,57 @@
+## The *check-apps.ps1* Script
+
+This PowerShell script queries application details and list it.
+
+## Parameters
+```powershell
+check-apps.ps1 [<CommonParameters>]
+
+[<CommonParameters>]
+    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
+    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
+```
+
+## Example
+```powershell
+PS> ./check-apps
+
+```
+
+## Notes
+Author: Markus Fleschutz | License: CC0
+
+## Related Links
+https://github.com/fleschutz/PowerShell
+
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Query application details
+.DESCRIPTION
+	This PowerShell script queries application details and list it.
+.EXAMPLE
+	PS> ./check-apps
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	if ($IsLinux) {
+		# TODO
+	} else {
+		Write-Progress "Querying installed apps and available updates..."
+		$NumAppsInstalled = (Get-AppxPackage).Count
+		$NumUpdates = (winget upgrade).Count - 5
+		"✅ $NumAppsInstalled apps installed, $NumUpdates updates available"
+	}
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
+*Generated by convert-ps2md.ps1 using the comment-based help of check-apps.ps1*

Docs/check-battery.md

@@ -0,0 +1,67 @@
+## The *check-battery.ps1* Script
+
+This PowerShell script checks and prints the battery status.
+
+## Parameters
+```powershell
+check-battery.ps1 [<CommonParameters>]
+
+[<CommonParameters>]
+    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
+    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
+```
+
+## Example
+```powershell
+PS> ./check-battery
+
+```
+
+## Notes
+Author: Markus Fleschutz | License: CC0
+
+## Related Links
+https://github.com/fleschutz/PowerShell
+
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Checks the battery status
+.DESCRIPTION
+	This PowerShell script checks and prints the battery status.
+.EXAMPLE
+	PS> ./check-battery
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	if ($IsLinux) {
+		# TODO
+	} else {
+		Add-Type -Assembly System.Windows.Forms
+		$Details = [System.Windows.Forms.SystemInformation]::PowerStatus
+		if ($Details.BatteryChargeStatus -eq "NoSystemBattery") {
+			$BatteryStatus = "No battery"
+		} else {
+			[int]$Percent = 100*$Details.BatteryLifePercent
+			[int]$Remaining = $Details.BatteryLifeRemaining / 60
+			$BatteryStatus = "Battery $Percent%, $Remaining min left"
+		}
+		switch ($Details.PowerLineStatus) {
+		"Online"  { $PowerStatus = "plugged in to AC power" }
+		"Offline" { $PowerStatus = "disconnected from AC power" }
+		}
+		"✅ $BatteryStatus, $PowerStatus"
+	}
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
+*Generated by convert-ps2md.ps1 using the comment-based help of check-battery.ps1*

Docs/check-bios.md

@@ -0,0 +1,62 @@
+## The *check-bios.ps1* Script
+
+This PowerShell script queries BIOS details and prints it.
+
+## Parameters
+```powershell
+check-bios.ps1 [<CommonParameters>]
+
+[<CommonParameters>]
+    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
+    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
+```
+
+## Example
+```powershell
+PS> ./check-bios
+✅ BIOS V1.10 by INSYDE Corp. (S/N NXA82EV0EBB07600, version ACRSYS - 2)
+
+```
+
+## Notes
+Author: Markus Fleschutz | License: CC0
+
+## Related Links
+https://github.com/fleschutz/PowerShell
+
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Checks BIOS details
+.DESCRIPTION
+	This PowerShell script queries BIOS details and prints it.
+.EXAMPLE
+	PS> ./check-bios
+	✅ BIOS V1.10 by INSYDE Corp. (S/N NXA82EV0EBB07600, version ACRSYS - 2)
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	Write-Progress "Querying BIOS details..."
+	if ($IsLinux) {
+		# TODO
+	} else {
+		$BIOS = Get-CimInstance -ClassName Win32_BIOS
+		$Manufacturer = $BIOS.Manufacturer
+		$Model = $BIOS.Name
+		$Serial = $BIOS.SerialNumber
+		$Version = $BIOS.Version
+		"✅ BIOS $Model by $Manufacturer (S/N $Serial, version $Version)"
+	}
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
+*Generated by convert-ps2md.ps1 using the comment-based help of check-bios.ps1*

Docs/check-cpu.md

@@ -1,27 +1,78 @@
-## check-cpu.ps1 - Checks the CPU temperature
+## The *check-cpu.ps1* Script
+
+check-cpu.ps1 
 
-This PowerShell script checks the CPU temperature.
 
 ## Parameters
 ```powershell
-check-cpu.ps1 [<CommonParameters>]
+
 
 [<CommonParameters>]
     This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
     WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
 ```
 
-## Example
+## Source Code
 ```powershell
-PS> ./check-cpu
+<#
-✔️ CPU has 30.3 °C
+.SYNOPSIS
+	Queries and prints CPU details
+.DESCRIPTION
+	This PowerShell script queries CPU details (name, type, speed, temperature, etc.) and prints it.
+.EXAMPLE
+	PS> ./check-cpu
+	✅ CPU AMD Ryzen 5 5500U with Radeon Graphics (CPU0, 2100MHz, 31.3°C)
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
 
+function GetCPUTemperatureInCelsius {
+	$Temp = 99999.9 # unsupported
+	if ($IsLinux) {
+		if (Test-Path "/sys/class/thermal/thermal_zone0/temp" -pathType leaf) {
+			[int]$IntTemp = Get-Content "/sys/class/thermal/thermal_zone0/temp"
+			$Temp = [math]::round($IntTemp / 1000.0, 1)
+		}
+	} else {
+		$Objects = Get-WmiObject -Query "SELECT * FROM Win32_PerfFormattedData_Counters_ThermalZoneInformation" -Namespace "root/CIMV2"
+		foreach ($Obj in $Objects) {
+			$HiPrec = $Obj.HighPrecisionTemperature
+			$Temp = [math]::round($HiPrec / 100.0, 1)
+		}
+	}
+	return $Temp;
+}
+
+try {
+	Write-Progress "Querying CPU details ..."
+	$Celsius = GetCPUTemperatureInCelsius
+	if ($Celsius -eq 99999.9) {
+		$Temp = "no temp"
+	} elseif ($Celsius -gt 50) {
+		$Temp = "⚠️$($Celsius)°C"
+	} elseif ($Celsius -lt 0) {
+		$Temp = "⚠️$($Celsius)°C"
+	} else {
+		$Temp = "$($Celsius)°C"
+	} 
+
+	if ($IsLinux) {
+		"✅ CPU has $Temp"
+	} else {
+		$Details = Get-WmiObject -Class Win32_Processor
+		$CPUName = $Details.Name.trim()
+		$DeviceID = $Details.DeviceID
+		$Speed = "$($Details.MaxClockSpeed)MHz"
+		$Socket = $Details.SocketDesignation
+		"✅ CPU $CPUName ($DeviceID, $Speed, socket $Socket, $Temp)"
+	}
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
 ```
 
-## Notes
-Author: Markus Fleschutz / License: CC0
-
-## Related Links
-https://github.com/fleschutz/PowerShell
-
 *Generated by convert-ps2md.ps1 using the comment-based help of check-cpu.ps1*

Docs/check-day.md

@@ -1,4 +1,4 @@
-## check-day.ps1 - Determines the current day
+## The *check-day.ps1* Script
 
 This PowerShell script determines and speaks the current day by text-to-speech (TTS).
 
@@ -19,9 +19,36 @@ PS> ./check-day
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Determines the current day 
+.DESCRIPTION
+	This PowerShell script determines and speaks the current day by text-to-speech (TTS).
+.EXAMPLE
+	PS> ./check-day
+	✔️ It's Sunday.
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	[system.threading.thread]::currentthread.currentculture=[system.globalization.cultureinfo]"en-US"
+	$Weekday = (Get-Date -format "dddd")
+	& "$PSScriptRoot/speak-english.ps1" "It's $Weekday."
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of check-day.ps1*

Docs/check-dns-server.md

@@ -0,0 +1,72 @@
+## The *check-dns-server.ps1* Script
+
+check-dns-server.ps1 
+
+
+## Parameters
+```powershell
+
+
+[<CommonParameters>]
+    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
+    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
+```
+
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Checks DNS server
+.DESCRIPTION
+	This PowerShell script checks the speed of public DNS server.
+.EXAMPLE
+	PS> ./check-dns-server
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+function CheckDNS { param($Name, $PriIPv4, $SecIPv4)
+	$StopWatch = [system.diagnostics.stopwatch]::startNew()
+	$null = (nslookup whitehouse.gov $PriIPv4)
+	[int]$PriIPv4Elapsed = $StopWatch.Elapsed.TotalMilliseconds
+
+	$StopWatch = [system.diagnostics.stopwatch]::startNew()
+	$null = (nslookup whitehouse.gov $SecIPv4)
+	[int]$SecIPv4Elapsed = $StopWatch.Elapsed.TotalMilliseconds
+
+	"   `"$Name`"; `"$PriIPv4`"; `"$PriIPv4Elapsed ms`"; `"$SecIPv4`"; `"$SecIPv4Elapsed ms`"; "
+}
+ 
+try {
+	"Checking speed of public DNS server..."
+	"  `"Company`"; `"IPv4 primary`"; `"Latency in ms`"; `"IPv4 secondary`"; `"Latency in ms`"; "
+	CheckDNS "Cloudflare" 1.1.1.1 1.0.0.1
+	CheckDNS "Cloudflare with malware blocklist" 1.1.1.2 1.0.0.2
+	CheckDNS "Cloudflare with malware+adult blocklist" 1.1.1.3 1.0.0.3
+	CheckDNS "DNS.Watch" 84.200.69.80 84.200.70.40 
+	CheckDNS "FreeDNS Vienna" 37.235.1.174 37.235.1.177
+	CheckDNS "Google Public DNS" 8.8.8.8 8.8.4.4
+	CheckDNS "Level3 one" 4.2.2.1 4.2.2.1
+	CheckDNS "Level3 two" 4.2.2.2 4.2.2.2 
+	CheckDNS "Level3 three" 4.2.2.3 4.2.2.3
+	CheckDNS "Level3 four" 4.2.2.4 4.2.2.4
+	CheckDNS "Level3 five" 4.2.2.5 4.2.2.5
+	CheckDNS "Level3 six" 4.2.2.6 4.2.2.6
+	CheckDNS "OpenDNS Basic" 208.67.222.222 208.67.220.220 
+	CheckDNS "OpenDNS Family Shield" 208.67.222.123 208.67.220.123 
+	CheckDNS "OpenNIC" 94.247.43.254 94.247.43.254
+	CheckDNS "Quad9 with malware blocklist, with DNSSEC" 9.9.9.9 9.9.9.9
+	CheckDNS "Quad9, no malware blocklist, no DNSSEC" 9.9.9.10 9.9.9.10
+	CheckDNS "Quad9, with malware blocklist, with DNSSEC, with EDNS" 9.9.9.11 9.9.9.11
+	CheckDNS "Quad9, with malware blocklist, with DNSSEC, NXDOMAIN only" 9.9.9.12 9.9.9.12 
+	CheckDNS "Verisign Public DNS" 64.6.64.6 64.6.65.6
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
+*Generated by convert-ps2md.ps1 using the comment-based help of check-dns-server.ps1*

Docs/check-dns.md

@@ -1,6 +1,6 @@
-## check-dns.ps1 - Checks the DNS resolution
+## The *check-dns.ps1* Script
 
-This PowerShell script checks the DNS resolution with frequently used domain names.
+This PowerShell script measures and prints the DNS resolution speed by using 200 frequently used domain names.
 
 ## Parameters
 ```powershell
@@ -14,14 +14,56 @@ check-dns.ps1 [<CommonParameters>]
 ## Example
 ```powershell
 PS> ./check-dns
-✔️ DNS resolution is 11.8 domains per second
 
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Checks the DNS resolution 
+.DESCRIPTION
+	This PowerShell script measures and prints the DNS resolution speed by using 200 frequently used domain names.
+.EXAMPLE
+	PS> ./check-dns
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+ 
+try {
+	Write-Progress "⏳ Step 1/2 - Reading from Data/frequent-domains.csv..."
+	$Table = Import-CSV "$PSScriptRoot/../Data/frequent-domains.csv"
+	$NumRows = $Table.Length
+
+	Write-Progress "⏳ Step 2/2 - Resolving $NumRows domains..."
+	$StopWatch = [system.diagnostics.stopwatch]::startNew()
+	if ($IsLinux) {
+		foreach($Row in $Table){$nop=dig $Row.Domain +short}
+	} else {
+		foreach($Row in $Table){$nop=Resolve-DNSName $Row.Domain}
+	}
+
+	[float]$Elapsed = $StopWatch.Elapsed.TotalSeconds
+	$Average = [math]::round($NumRows / $Elapsed, 1)
+
+	if ($Average -gt 10.0) {
+		"✅ DNS resolves $Average domains per second"
+	} else {  
+		"⚠️ DNS resolves only $Average domains per second!"
+	}
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of check-dns.ps1*

Docs/check-drive-space.md

@@ -1,4 +1,4 @@
-## check-drive-space.ps1 - Checks a drive for free space left
+## The *check-drive-space.ps1* Script
 
 This PowerShell script checks a drive for free space left (20 GB by default).
 
@@ -37,9 +37,52 @@ PS> ./check-drive-space C
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Checks a drive for free space left 
+.DESCRIPTION
+	This PowerShell script checks a drive for free space left (20 GB by default).
+.PARAMETER Drive
+	Specifies the drive to check
+.PARAMETER MinLevel
+	Specifies the minimum level in Gigabyte
+.EXAMPLE
+	PS> ./check-drive-space C
+	✔️ 172 GB left on drive C (61 of 233 GB used)
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+param([string]$Drive = "", [int]$MinLevel = 20) # minimum level in GB
+
+try {
+	if ($Drive -eq "" ) { $Drive = read-host "Enter drive to check" }
+
+	$DriveDetails = (get-psdrive $Drive)
+	[int]$Free = (($DriveDetails.Free / 1024) / 1024) / 1024
+	[int]$Used = (($DriveDetails.Used / 1024) / 1024) / 1024
+	[int]$Total = ($Used + $Free)
+
+	if ($Free -lt $MinLevel) {
+        	write-warning "Drive $Drive has only $Free GB left to use! ($Used of $Total GB used, minimum is $MinLevel GB)"
+		exit 1
+	}
+
+	& "$PSScriptRoot/speak-english.ps1" "Drive $Drive has $Free GB left ($Total GB total)"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of check-drive-space.ps1*

Docs/check-drives.md

@@ -1,17 +1,17 @@
-## check-drives.ps1 - Checks all drives for free space left
+## The *check-drives.ps1* Script
 
-This PowerShell script checks all drives for free space left (20 GB by default).
+This PowerShell script checks all drives for free space left.
 
 ## Parameters
 ```powershell
 check-drives.ps1 [[-MinLevel] <Int32>] [<CommonParameters>]
 
 -MinLevel <Int32>
-    Specifies the minimum level in Gigabyte
+    Specifies the minimum warning level (10 GB by default)
     
     Required?                    false
     Position?                    1
-    Default value                20
+    Default value                10
     Accept pipeline input?       false
     Accept wildcard characters?  false
 
@@ -23,14 +23,74 @@ check-drives.ps1 [[-MinLevel] <Int32>] [<CommonParameters>]
 ## Example
 ```powershell
 PS> ./check-drives
-✔️ Drive C has 172GB left (233GB total)
 
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Checks the drive space
+.DESCRIPTION
+	This PowerShell script checks all drives for free space left.
+.PARAMETER MinLevel
+	Specifies the minimum warning level (10 GB by default)
+.EXAMPLE
+	PS> ./check-drives
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+param([int]$MinLevel = 10) # 10 GB minimum
+
+function Bytes2String { param([int64]$Bytes)
+        if ($Bytes -lt 1000) { return "$Bytes bytes" }
+        $Bytes /= 1000
+        if ($Bytes -lt 1000) { return "$($Bytes)KB" }
+        $Bytes /= 1000
+        if ($Bytes -lt 1000) { return "$($Bytes)MB" }
+        $Bytes /= 1000
+        if ($Bytes -lt 1000) { return "$($Bytes)GB" }
+        $Bytes /= 1000
+        if ($Bytes -lt 1000) { return "$($Bytes)TB" }
+        $Bytes /= 1000
+        if ($Bytes -lt 1000) { return "$($Bytes)PB" }
+        $Bytes /= 1000
+        if ($Bytes -lt 1000) { return "$($Bytes)EB" }
+}
+
+try {
+	$Drives = Get-PSDrive -PSProvider FileSystem 
+	foreach($Drive in $Drives) {
+		$ID = $Drive.Name
+		$Details = (Get-PSDrive $ID)
+		[int64]$Free = $Details.Free
+ 		[int64]$Used = $Details.Used
+		[int64]$Total = ($Used + $Free)
+
+		if ($Total -eq 0) {
+			"✅ Drive $ID is empty"
+		} elseif ($Free -lt $MinLevel) {
+			"⚠️ Drive $ID has only $(Bytes2String $Free) of $(Bytes2String $Total) left to use!"
+		} elseif ($Used -lt $Free) {
+			"✅ Drive $ID uses $(Bytes2String $Used) of $(Bytes2String $Total)"
+		} else {
+			"✅ Drive $ID has $(Bytes2String $Free) free of $(Bytes2String $Total)"
+		}
+	}
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of check-drives.ps1*

Docs/check-dusk.md

@@ -1,4 +1,6 @@
-## check-dusk.ps1 - check-dusk.ps1 
+## The *check-dusk.ps1* Script
+
+check-dusk.ps1 
 
 
 ## Parameters
@@ -10,4 +12,51 @@
     WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
 ```
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Checks the time of dusk 
+.DESCRIPTION
+	This PowerShell script queries the time of dusk and answers by text-to-speech (TTS).
+.EXAMPLE
+	PS> ./check-dusk
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+function TimeSpanToString { param([TimeSpan]$Delta)
+        $Result = ""
+        if ($Delta.Hours -eq 1) {       $Result += "1 hour and "
+        } elseif ($Delta.Hours -gt 1) { $Result += "$($Delta.Hours) hours and "
+        }
+        if ($Delta.Minutes -eq 1) { $Result += "1 minute"
+        } else {                    $Result += "$($Delta.Minutes) minutes"
+        }
+        return $Result
+}
+
+try {
+	[system.threading.thread]::currentThread.currentCulture=[system.globalization.cultureInfo]"en-US"
+	$String = (Invoke-WebRequest http://wttr.in/?format="%d" -UserAgent "curl" -useBasicParsing).Content
+	$Hour,$Minute,$Second = $String -split ':'
+	$Dusk = Get-Date -Hour $Hour -Minute $Minute -Second $Second
+	$Now = [DateTime]::Now
+	if ($Now -lt $Dusk) {
+                $TimeSpan = TimeSpanToString($Dusk - $Now)
+                $Reply = "Dusk is in $TimeSpan at $($Dusk.ToShortTimeString())."
+        } else {
+                $TimeSpan = TimeSpanToString($Now - $Dusk)
+                $Reply = "Dusk was $TimeSpan ago at $($Dusk.ToShortTimeString())."
+        }
+	& "$PSScriptRoot/speak-english.ps1" "$Reply"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of check-dusk.ps1*

Docs/check-easter-sunday.md

@@ -1,4 +1,4 @@
-## check-easter-sunday.ps1 - Checks the time until Easter Sunday
+## The *check-easter-sunday.ps1* Script
 
 This PowerShell script checks the time until Easter Sunday and replies by text-to-speech (TTS).
 
@@ -18,9 +18,41 @@ PS> ./check-easter-sunday
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Checks the time until Easter Sunday
+.DESCRIPTION
+	This PowerShell script checks the time until Easter Sunday and replies by text-to-speech (TTS).
+.EXAMPLE
+	PS> ./check-easter-sunday
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	$Now = [DateTime]::Now
+	$Easter = [Datetime]("04/17/2022")
+	if ($Now -lt $Easter) {
+		$Diff = $Easter – $Now
+		& "$PSScriptRoot/speak-english.ps1" "Easter Sunday on April 17 is in $($Diff.Days) days."
+	} else {
+		$Diff = $Now - $Easter
+		& "$PSScriptRoot/speak-english.ps1" "Easter Sunday on April 17 was $($Diff.Days) days ago."
+	}
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of check-easter-sunday.ps1*

Docs/check-file-system.md

@@ -1,4 +1,4 @@
-## check-file-system.ps1 - Checks the file system of a drive (needs admin rights)
+## The *check-file-system.ps1* Script
 
 This PowerShell script checks the file system of a drive. It needs admin rights.
 
@@ -28,9 +28,45 @@ PS> ./check-file-system C
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Checks the file system of a drive (needs admin rights)
+.DESCRIPTION
+	This PowerShell script checks the file system of a drive. It needs admin rights.
+.PARAMETER Drive
+	Specifies the drive to check
+.EXAMPLE
+	PS> ./check-file-system C
+	✔️ file system on drive C is clean
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+#Requires -RunAsAdministrator
+
+param([string]$Drive = "")
+
+try {
+	if ($Drive -eq "" ) { $Drive = read-host "Enter drive (letter) to check" }
+
+	$Result = repair-volume -driveLetter $Drive -scan
+	if ($Result -ne "NoErrorsFound") { throw "'repair-volume' failed" }
+
+	& "$PSScriptRoot/speak-english.ps1" "File system on drive $Drive is clean."
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of check-file-system.ps1*

Docs/check-gpu.md

@@ -0,0 +1,63 @@
+## The *check-gpu.ps1* Script
+
+check-gpu.ps1 
+
+
+## Parameters
+```powershell
+
+
+[<CommonParameters>]
+    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
+    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
+```
+
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+        Checks the GPU 
+.DESCRIPTION
+        This PowerShell script queries GPU details and prints it.
+.EXAMPLE
+        PS> ./check-gpu
+.LINK
+        https://github.com/fleschutz/PowerShell
+.NOTES
+        Author: Markus Fleschutz | License: CC0
+#>
+
+function Bytes2String { param([int64]$Bytes)
+        if ($Bytes -lt 1000) { return "$Bytes bytes" }
+        $Bytes /= 1000
+        if ($Bytes -lt 1000) { return "$($Bytes)KB" }
+        $Bytes /= 1000
+        if ($Bytes -lt 1000) { return "$($Bytes)MB" }
+        $Bytes /= 1000
+        if ($Bytes -lt 1000) { return "$($Bytes)GB" }
+        $Bytes /= 1000
+        return "$($Bytes)TB"
+}
+
+try {
+	if ($IsLinux) {
+		# TODO
+	} else {
+		$Details = Get-WmiObject Win32_VideoController
+		$Model = $Details.Caption
+		$RAMSize = $Details.AdapterRAM
+		$ResWidth = $Details.CurrentHorizontalResolution
+		$ResHeight = $Details.CurrentVerticalResolution
+		$BitsPerPixel = $Details.CurrentBitsPerPixel
+		$RefreshRate = $Details.CurrentRefreshRate
+		$DriverVersion = $Details.DriverVersion
+		$Status = $Details.Status
+		 "✅ GPU $($Model) ($(Bytes2String $RAMSize) RAM, $($ResWidth)x$($ResHeight) pixels, $BitsPerPixel bit, $RefreshRate Hz, driver $DriverVersion, status $Status)"
+	}
+} catch {
+        "⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+        exit 1
+}
+```
+
+*Generated by convert-ps2md.ps1 using the comment-based help of check-gpu.ps1*

Docs/check-health.md

@@ -1,6 +1,6 @@
-## check-health.ps1 - Checks the computer health
+## The *check-health.ps1* Script
 
-This PowerShell script checks the health of the local computer.
+This PowerShell script checks some health parameter of the local computer.
 
 ## Parameters
 ```powershell
@@ -14,18 +14,52 @@ check-health.ps1 [<CommonParameters>]
 ## Example
 ```powershell
 PS> ./check-health
-✔️ 1213 GB left for swap space (67 of 1280 GB used)
-✔️ 172 GB left on drive C (61 of 233 GB used)
-✔️ 30.3 °C CPU temperature - good
-✔️ DNS resolution is 19.7 domains per second
-✔️ 29 ms ping average (13 ms min, 110 ms max, 10 hosts)
 
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Checks the system health 
+.DESCRIPTION
+	This PowerShell script checks some health parameter of the local computer.
+.EXAMPLE
+	PS> ./check-health
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+" "
+& "$PSScriptRoot/write-green.ps1" "   H A R D W A R E"
+& "$PSScriptRoot/check-cpu.ps1"
+& "$PSScriptRoot/check-ram.ps1"
+& "$PSScriptRoot/check-gpu.ps1"
+& "$PSScriptRoot/check-bios.ps1"
+& "$PSScriptRoot/check-smart-devices.ps1"
+& "$PSScriptRoot/check-drives.ps1"
+& "$PSScriptRoot/check-battery.ps1"
+" "
+& "$PSScriptRoot/write-green.ps1" "   S O F T W A R E"
+& "$PSScriptRoot/check-os.ps1"
+& "$PSScriptRoot/check-powershell.ps1"
+& "$PSScriptRoot/check-apps.ps1"
+& "$PSScriptRoot/check-uptime.ps1"
+& "$PSScriptRoot/check-time-zone.ps1"
+& "$PSScriptRoot/check-swap-space.ps1"
+& "$PSScriptRoot/check-dns.ps1"
+& "$PSScriptRoot/check-ping.ps1"
+& "$PSScriptRoot/check-vpn.ps1"
+& "$PSScriptRoot/check-pending-reboot.ps1"
+exit 0 # success
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of check-health.ps1*

Docs/check-independence-day.md

@@ -1,4 +1,4 @@
-## check-independence-day.ps1 - Checks the time until Independence Day
+## The *check-independence-day.ps1* Script
 
 This PowerShell script checks the time until Indepence Day and replies by text-to-speech (TTS).
 
@@ -18,9 +18,41 @@ PS> ./check-independence-day
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Checks the time until Independence Day
+.DESCRIPTION
+	This PowerShell script checks the time until Indepence Day and replies by text-to-speech (TTS).
+.EXAMPLE
+	PS> ./check-independence-day
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	$Now = [DateTime]::Now
+	$IndependenceDay = [Datetime]("07/04/" + $Now.Year)
+	if ($Now -lt $IndependenceDay) {
+		$Diff = $IndependenceDay – $Now
+		& "$PSScriptRoot/speak-english.ps1" "Independence Day on July 4th is in $($Diff.Days) days."
+	} else {
+		$Diff = $Now - $IndependenceDay
+		& "$PSScriptRoot/speak-english.ps1" "Independence Day on July 4th was $($Diff.Days) days ago."
+	}
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of check-independence-day.ps1*

Docs/check-ipv4-address.md

@@ -1,4 +1,4 @@
-## check-ipv4-address.ps1 - Checks an IPv4 address for validity
+## The *check-ipv4-address.ps1* Script
 
 This PowerShell script checks the given IPv4 address for validity.
 
@@ -28,9 +28,54 @@ PS> ./check-ipv4-address 192.168.11.22
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Checks an IPv4 address for validity
+.DESCRIPTION
+	This PowerShell script checks the given IPv4 address for validity.
+.PARAMETER Address
+	Specifies the IPv4 address to check
+.EXAMPLE
+	PS> ./check-ipv4-address 192.168.11.22
+	✔️ IPv4 192.168.11.22 is valid
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+param([string]$Address = "")
+
+function IsIPv4AddressValid { param([string]$IP)
+	$RegEx = "^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$"
+	if ($IP -match $RegEx) {
+		return $true
+	} else {
+		return $false
+	}
+}
+
+try {
+	if ($Address -eq "" ) { $Address = read-host "Enter IPv4 address to validate" }
+
+	if (IsIPv4AddressValid $Address) {
+		"✔️ IPv4 $Address is valid"
+		exit 0 # success
+	} else {
+		write-warning "Invalid IPv4 address: $Address"
+		exit 1
+	}
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of check-ipv4-address.ps1*

Docs/check-ipv6-address.md

@@ -1,4 +1,4 @@
-## check-ipv6-address.ps1 - Checks an IPv6 address for validity
+## The *check-ipv6-address.ps1* Script
 
 This PowerShell script checks the given IPv6 address for validity
 
@@ -28,9 +28,68 @@ PS> ./check-ipv6-address fe80::200:5aee:feaa:20a2
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Checks an IPv6 address for validity
+.DESCRIPTION
+	This PowerShell script checks the given IPv6 address for validity
+.PARAMETER Address
+	Specifies the IPv6 address to check
+.EXAMPLE
+	PS> ./check-ipv6-address fe80::200:5aee:feaa:20a2
+	✔️ IPv6 fe80::200:5aee:feaa:20a2 is valid
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+param([string]$Address = "")
+
+function IsIPv6AddressValid { param([string]$IP)
+    $IPv4Regex = '(((25[0-5]|2[0-4][0-9]|[0-1]?[0-9]{1,2})\.){3}(25[0-5]|2[0-4][0-9]|[0-1]?[0-9]{1,2}))'
+    $G = '[a-f\d]{1,4}'
+    $Tail = @(":",
+    "(:($G)?|$IPv4Regex)",
+    ":($IPv4Regex|$G(:$G)?|)",
+    "(:$IPv4Regex|:$G(:$IPv4Regex|(:$G){0,2})|:)",
+    "((:$G){0,2}(:$IPv4Regex|(:$G){1,2})|:)",
+    "((:$G){0,3}(:$IPv4Regex|(:$G){1,2})|:)",
+    "((:$G){0,4}(:$IPv4Regex|(:$G){1,2})|:)")
+    [string] $IPv6RegexString = $G
+    $Tail | foreach { $IPv6RegexString = "${G}:($IPv6RegexString|$_)" }
+    $IPv6RegexString = ":(:$G){0,5}((:$G){1,2}|:$IPv4Regex)|$IPv6RegexString"
+    $IPv6RegexString = $IPv6RegexString -replace '\(' , '(?:' # make all groups non-capturing
+    [regex] $IPv6Regex = $IPv6RegexString
+    if ($IP -imatch "^$IPv6Regex$") {
+    	return $true
+    } else {
+    	return $false
+    }
+}
+
+try {
+	if ($Address -eq "" ) {
+		$Address = read-host "Enter IPv6 address to validate"
+	}
+	if (IsIPv6AddressValid $Address) {
+		"✔️  IPv6 $Address is valid"
+		exit 0 # success
+	} else {
+		write-warning "Invalid IPv6 address: $Address"
+		exit 1
+	}
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of check-ipv6-address.ps1*

Docs/check-iss-position.md

@@ -1,4 +1,4 @@
-## check-iss-position.ps1 - Checks the ISS position
+## The *check-iss-position.ps1* Script
 
 This PowerShell script queries the position of the International Space Station (ISS) and replies by text-to-speech (TTS).
 
@@ -18,9 +18,35 @@ PS> ./check-iss-position
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Checks the ISS position
+.DESCRIPTION
+	This PowerShell script queries the position of the International Space Station (ISS) and replies by text-to-speech (TTS).
+.EXAMPLE
+	PS> ./check-iss-position
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	$ISS = (Invoke-WebRequest "http://api.open-notify.org/iss-now.json" -userAgent "curl" -useBasicParsing).Content | ConvertFrom-Json
+
+	& "$PSScriptRoot/speak-english.ps1" "The International Space Station is currently at $($ISS.iss_position.longitude)° longitude and $($ISS.iss_position.latitude)° latitude."
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of check-iss-position.ps1*

Docs/check-mac-address.md

@@ -1,4 +1,4 @@
-## check-mac-address.ps1 - Checks the given MAC address for validity
+## The *check-mac-address.ps1* Script
 
 This PowerShell script checks the given MAC address for validity
 Supported MAC address formats are: 00:00:00:00:00:00 or 00-00-00-00-00-00 or 000000000000.
@@ -29,9 +29,56 @@ PS> ./check-mac-address 11:22:33:44:55:66
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Checks the given MAC address for validity
+.DESCRIPTION
+	This PowerShell script checks the given MAC address for validity
+	Supported MAC address formats are: 00:00:00:00:00:00 or 00-00-00-00-00-00 or 000000000000.
+.PARAMETER MAC
+	Specifies the MAC address to check
+.EXAMPLE
+	PS> ./check-mac-address 11:22:33:44:55:66
+	✔️ MAC address 11:22:33:44:55:66 is valid
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+param([string]$MAC = "")
+
+function IsMACAddressValid { param([string]$mac)
+	$RegEx = "^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})|([0-9A-Fa-f]{2}){6}$"
+	if ($mac -match $RegEx) {
+		return $true
+	} else {
+		return $false
+	}
+}
+
+try {
+	if ($MAC -eq "" ) {
+		$MAC = read-host "Enter MAC address to validate"
+	}
+	if (IsMACAddressValid $MAC) {
+		"✔️ MAC address $MAC is valid"
+		exit 0 # success
+	} else {
+		write-warning "Invalid MAC address: $MAC"
+		exit 1
+	}
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of check-mac-address.ps1*

Docs/check-midnight.md

@@ -1,4 +1,6 @@
-## check-midnight.ps1 - check-midnight.ps1 
+## The *check-midnight.ps1* Script
+
+check-midnight.ps1 
 
 
 ## Parameters
@@ -10,4 +12,49 @@
     WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
 ```
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Checks for Midnight
+.DESCRIPTION
+	This PowerShell script checks the time until Midnight and replies by text-to-speech (TTS).
+.EXAMPLE
+	PS> ./check-midnight
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+function TimeSpanToString { param([TimeSpan]$Delta)
+	$Result = ""
+	if ($Delta.Hours -eq 1) {       $Result += "1 hour and "
+	} elseif ($Delta.Hours -gt 1) { $Result += "$($Delta.Hours) hours and "
+	}
+	if ($Delta.Minutes -eq 1) { $Result += "1 minute"
+	} else {                    $Result += "$($Delta.Minutes) minutes"
+	}
+	return $Result
+}
+
+try {
+	$Now = [DateTime]::Now
+	if ($Now.Hour -lt 12) {
+		$Midnight = Get-Date -Hour 0 -Minute 0 -Second 0
+		$TimeSpan = TimeSpanToString($Now - $Midnight)
+		$Reply = "Midnight was $TimeSpan ago."
+	} else {
+		$Midnight = Get-Date -Hour 23 -Minute 59 -Second 59
+		$TimeSpan = TimeSpanToString($Midnight - $Now)
+		$Reply = "Midnight is in $TimeSpan."
+	}
+	& "$PSScriptRoot/speak-english.ps1" "$Reply"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of check-midnight.ps1*

Docs/check-month.md

@@ -1,4 +1,4 @@
-## check-month.ps1 - Gets the current month name
+## The *check-month.ps1* Script
 
 This PowerShell script determines and speaks the current month name by text-to-speech (TTS).
 
@@ -19,9 +19,36 @@ PS> ./check-month
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Gets the current month name
+.DESCRIPTION
+	This PowerShell script determines and speaks the current month name by text-to-speech (TTS).
+.EXAMPLE
+	PS> ./check-month
+	✔️ It's December.
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	[system.threading.thread]::currentthread.currentculture=[system.globalization.cultureinfo]"en-US"
+	$MonthName = (Get-Date -UFormat %B)
+	& "$PSScriptRoot/speak-english.ps1" "It's $MonthName."
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of check-month.ps1*

Docs/check-moon-phase.md

@@ -1,4 +1,4 @@
-## check-moon-phase.ps1 - Checks the Moon phase
+## The *check-moon-phase.ps1* Script
 
 This PowerShell script determines the Moon phase and answers by text-to-speech (TTS).
 
@@ -18,9 +18,56 @@ PS> ./check-moon-phase
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Checks the Moon phase
+.DESCRIPTION
+	This PowerShell script determines the Moon phase and answers by text-to-speech (TTS).
+.EXAMPLE
+	PS> ./check-moon-phase
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	$LunarCycle = 29.53058868 # synodic period in days, time between successive new moons
+	$LunarHalfCycle = $LunarCycle / 2.0
+	$Phases = @("New moon", "Waxing crescent moon", "First quarter moon", "Waxing gibbous moon", "Full moon", "Waning gibbous moon", "Last quarter moon", "Waning crescent moon")
+	$PhaseLength = $LunarCycle / 8.0
+	$PhaseHalfLength = $PhaseLength / 2.0
+
+	$RefDate = get-date -Year 2021 -Month 12 -Day 4 -Hour 6 -Minute 43 # Dec 4, 2021 06:43 UTC [New Moon]
+	$Now = get-date
+	$TimeInterval = New-TimeSpan -Start $RefDate -End $Now
+	$Days = $TimeInterval.TotalDays
+
+	$MDays = $Days % $LunarCycle
+	$PhaseIndex = [int]($MDays * (8.0 / $LunarCycle))
+
+	$Visibility = [math]::Round((($Days % $LunarHalfCycle) * 100) / $LunarHalfCycle)
+	$Reply = "$($Phases[$PhaseIndex]) with $($Visibility)% visibility"
+
+	$MoonAge = [math]::Round($Days % $LunarCycle)	
+	if ($MoonAge -eq "0") {	      $Reply += " today"
+	} elseif ($MoonAge -eq "1") { $Reply += " since yesterday"
+	} else {                      $Reply += ", last new moon was $MoonAge days ago"
+	}
+
+	& "$PSScriptRoot/speak-english.ps1" "$Reply"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of check-moon-phase.ps1*

Docs/check-new-year.md

@@ -1,4 +1,4 @@
-## check-new-year.ps1 - Checks the time until New Year
+## The *check-new-year.ps1* Script
 
 This PowerShell script checks the time until New Year and replies by text-to-speech (TTS).
 
@@ -18,9 +18,40 @@ PS> ./check-new-year
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Checks the time until New Year
+.DESCRIPTION
+	This PowerShell script checks the time until New Year and replies by text-to-speech (TTS).
+.EXAMPLE
+	PS> ./check-new-year
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	$Now = [DateTime]::Now
+	$NewYear = [Datetime]("12/31/" + $Now.Year)
+	$Days = ($NewYear – $Now).Days + 1
+	if ($Days -gt 1) {
+		& "$PSScriptRoot/speak-english.ps1" "New Year is in $Days days."
+	} elseif ($Days -eq 1) {
+		& "$PSScriptRoot/speak-english.ps1" "New Year is tomorrow."
+	}
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of check-new-year.ps1*

Docs/check-noon.md

@@ -1,4 +1,6 @@
-## check-noon.ps1 - check-noon.ps1 
+## The *check-noon.ps1* Script
+
+check-noon.ps1 
 
 
 ## Parameters
@@ -10,4 +12,48 @@
     WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
 ```
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Checks for Noon
+.DESCRIPTION
+	This PowerShell script checks the time until Noon and replies by text-to-speech (TTS).
+.EXAMPLE
+	PS> ./check-noon
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+function TimeSpanToString { param([TimeSpan]$Delta)
+	$Result = ""
+	if ($Delta.Hours -eq 1) {       $Result += "1 hour and "
+	} elseif ($Delta.Hours -gt 1) { $Result += "$($Delta.Hours) hours and "
+	}
+	if ($Delta.Minutes -eq 1) { $Result += "1 minute"
+	} else {                    $Result += "$($Delta.Minutes) minutes"
+	}
+	return $Result
+}
+
+try {
+	$Now = [DateTime]::Now
+	$Noon = Get-Date -Hour 12 -Minute 0 -Second 0
+	if ($Now -lt $Noon) {
+		$TimeSpan = TimeSpanToString($Noon - $Now)
+		$Reply = "Noon is in $TimeSpan."
+	} else {
+		$TimeSpan = TimeSpanToString($Now - $Noon)
+		$Reply = "Noon was $TimeSpan ago."
+	}
+	& "$PSScriptRoot/speak-english.ps1" "$Reply"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of check-noon.ps1*

Docs/check-operating-system.md

@@ -1,6 +1,6 @@
-## check-operating-system.ps1 - Determines the exact OS version
+## The *check-operating-system.ps1* PowerShell Script
 
-This PowerShell script determines and says the exact operating system version by text-to-speech (TTS).
+This PowerShell script queries and lists operating system details.
 
 ## Parameters
 ```powershell
@@ -18,9 +18,47 @@ PS> ./check-operating-system
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Query OS details
+.DESCRIPTION
+	This PowerShell script queries and lists operating system details.
+.EXAMPLE
+	PS> ./check-operating-system
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	if ($IsLinux) {
+		"✅ $(uname -sr)."
+	} else {
+		$OS = Get-WmiObject -class Win32_OperatingSystem
+		$Name = $OS.Caption
+		$Arch = $OS.OSArchitecture
+		$Version = $OS.Version
+
+		[system.threading.thread]::currentthread.currentculture = [system.globalization.cultureinfo]"en-US"
+		$OSDetails = Get-CimInstance Win32_OperatingSystem
+		$BuildNo = $OSDetails.BuildNumber
+		$Serial = $OSDetails.SerialNumber
+		$InstallDate = $OSDetails.InstallDate
+		"✅ $($Name): $Arch, v$Version, S/N $Serial, installed $($InstallDate.ToShortDateString())"
+	} 
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of check-operating-system.ps1*

Docs/check-os.md

@@ -0,0 +1,64 @@
+## The *check-os.ps1* Script
+
+This PowerShell script queries and lists operating system details.
+
+## Parameters
+```powershell
+check-os.ps1 [<CommonParameters>]
+
+[<CommonParameters>]
+    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
+    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
+```
+
+## Example
+```powershell
+PS> ./check-os
+
+```
+
+## Notes
+Author: Markus Fleschutz | License: CC0
+
+## Related Links
+https://github.com/fleschutz/PowerShell
+
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Query OS details
+.DESCRIPTION
+	This PowerShell script queries and lists operating system details.
+.EXAMPLE
+	PS> ./check-os
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	if ($IsLinux) {
+		"✅ $(uname -sr)"
+	} else {
+		$OS = Get-WmiObject -class Win32_OperatingSystem
+		$Name = $OS.Caption
+		$Arch = $OS.OSArchitecture
+		$Version = $OS.Version
+
+		[system.threading.thread]::currentthread.currentculture = [system.globalization.cultureinfo]"en-US"
+		$OSDetails = Get-CimInstance Win32_OperatingSystem
+		$BuildNo = $OSDetails.BuildNumber
+		$Serial = $OSDetails.SerialNumber
+		$InstallDate = $OSDetails.InstallDate
+		"✅ $($Name) ($Arch, v$Version, S/N $Serial) installed on $($InstallDate.ToShortDateString())"
+	} 
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
+*Generated by convert-ps2md.ps1 using the comment-based help of check-os.ps1*

Docs/check-outlook.md

@@ -0,0 +1,60 @@
+## The *check-outlook.ps1* Script
+
+This PowerShell script checks the inbox of Outlook for new/unread mails.
+
+## Parameters
+```powershell
+check-outlook.ps1 [<CommonParameters>]
+
+[<CommonParameters>]
+    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
+    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
+```
+
+## Example
+```powershell
+PS> ./check-outlook
+
+```
+
+## Notes
+Author: Markus Fleschutz | License: CC0
+
+## Related Links
+https://github.com/fleschutz/PowerShell
+
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Checks Outlook's inbox 
+.DESCRIPTION
+	This PowerShell script checks the inbox of Outlook for new/unread mails.
+.EXAMPLE
+	PS> ./check-outlook
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	Add-Type -assembly "Microsoft.Office.Interop.Outlook"
+	$Outlook = New-Object -comobject Outlook.Application
+	$Namespace = $Outlook.GetNameSpace("MAPI")
+	$Inbox = $Namespace.GetDefaultFolder(6) # 6 = olFolderInbox
+	[int]$Unread = 0
+	foreach($Mail in $Inbox.Items) {
+		if ($Mail.Unread -eq $false) { continue }
+		"⚠️ New mail '$($Mail.Subject)' from $($Mail.SenderName)."
+		$Unread++
+	}
+	if ($Unread -eq 0) { "✅ No new mails." }
+	exit 0 # success
+} catch {
+	"Sorry: $($Error[0])"
+	exit 1
+}
+```
+
+*Generated by convert-ps2md.ps1 using the comment-based help of check-outlook.ps1*

Docs/check-pending-reboot.md

@@ -0,0 +1,82 @@
+## The *check-pending-reboot.ps1* Script
+
+check-pending-reboot.ps1 
+
+
+## Parameters
+```powershell
+
+
+[<CommonParameters>]
+    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
+    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
+```
+
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Check for pending reboots
+.DESCRIPTION
+	This PowerShell script checks different registry keys and values to determine if a reboot is pending.
+.EXAMPLE
+	./check-pending-reboot.ps1
+.LINK
+        https://github.com/fleschutz/PowerShell
+.NOTES
+        Author: Markus Fleschutz | License: CC0
+#>
+
+function Test-RegistryValue { param([parameter(Mandatory=$true)][ValidateNotNullOrEmpty()]$Path, [parameter(Mandatory=$true)] [ValidateNotNullOrEmpty()]$Value)
+	try {
+		Get-ItemProperty -Path $Path -Name $Value -EA Stop
+		return $true
+	} catch {
+		return $false
+	}
+}
+
+$Reason = ""
+
+if (Test-Path -Path "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\WindowsUpdate\Auto Update\RebootRequired") {
+	$Reason += ", found registry entry '...\WindowsUpdate\Auto Update\RebootRequired'"
+}
+if (Test-Path -Path "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\WindowsUpdate\Auto Update\PostRebootReporting") {
+	$Reason += ", found registry entry '...\WindowsUpdate\Auto Update\PostRebootReporting'"
+}
+if (Test-Path -Path "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Component Based Servicing\RebootPending") {
+	$Reason += ", found registry entry '...\Component Based Servicing\RebootPending'"
+}
+if (Test-Path -Path "HKLM:\SOFTWARE\Microsoft\ServerManager\CurrentRebootAttempts") {
+	$Reason += ", found registry entry '...\ServerManager\CurrentRebootAttempts'"
+}
+if (Test-RegistryValue -Path "HKLM:\Software\Microsoft\Windows\CurrentVersion\Component Based Servicing" -Value "RebootInProgress") {
+	$Reason += ", found registry entry '...\CurrentVersion\Component Based Servicing' with 'RebootInProgress'"
+}
+if (Test-RegistryValue -Path "HKLM:\Software\Microsoft\Windows\CurrentVersion\Component Based Servicing" -Value "PackagesPending") {
+	$Reason += ", found registry entry '...\CurrentVersion\Component Based Servicing' with 'PackagesPending'"
+}
+#if (Test-RegistryValue -Path "HKLM:\SYSTEM\CurrentControlSet\Control\Session Manager" -Value "PendingFileRenameOperations") {
+#	$Reason += ", found registry entry '...\CurrentControlSet\Control\Session Manager' with 'PendingFileRenameOperations'"
+#}
+if (Test-RegistryValue -Path "HKLM:\SYSTEM\CurrentControlSet\Control\Session Manager" -Value "PendingFileRenameOperations2") {
+	$Reason += ", found registry entry '...\CurrentControlSet\Control\Session Manager' with 'PendingFileRenameOperations2'"
+}
+if (Test-RegistryValue -Path "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce" -Value "DVDRebootSignal") {
+	$Reason += ", found registry entry '...\Windows\CurrentVersion\RunOnce' with 'DVDRebootSignal'"
+}
+if (Test-RegistryValue -Path "HKLM:\SYSTEM\CurrentControlSet\Services\Netlogon" -Value "JoinDomain") {
+	$Reason += ", found registry entry '...\CurrentControlSet\Services\Netlogon' with 'JoinDomain'"
+}
+if (Test-RegistryValue -Path "HKLM:\SYSTEM\CurrentControlSet\Services\Netlogon" -Value "AvoidSpnSet") {
+	$Reason += ", found registry entry '...\CurrentControlSet\Services\Netlogon' with 'AvoidSpnSet'"
+}
+if ($Reason -ne "") {
+	"⚠️ Pending reboot ($($Reason.substring(2)))"
+} else {
+	"✅ No pending reboot"
+}
+exit 0 # success
+```
+
+*Generated by convert-ps2md.ps1 using the comment-based help of check-pending-reboot.ps1*

Docs/check-ping.md

@@ -1,14 +1,13 @@
-## check-ping.ps1 - Checks the ping latency from the local computer to selected Internet hosts
+## The *check-ping.ps1* Script
 
-This PowerShell script checks the ping latency from the local computer to selected Internet hosts.
+This PowerShell script checks the ping latency from the local computer to some Internet hosts.
-The hosts by default are: amazon.com,bing.com,cnn.com,dropbox.com,facebook.com,google.com,live.com,twitter.com,youtube.com
 
 ## Parameters
 ```powershell
 check-ping.ps1 [[-hosts] <String>] [<CommonParameters>]
 
 -hosts <String>
-    Specifies the hosts to check (separated by comma)
+    Specifies the hosts to check, seperated by comma (default is: amazon.com,bing.com,cnn.com,dropbox.com,facebook.com,google.com,live.com,twitter.com,youtube.com)
     
     Required?                    false
     Position?                    1
@@ -24,14 +23,56 @@ check-ping.ps1 [[-hosts] <String>] [<CommonParameters>]
 ## Example
 ```powershell
 PS> ./check-ping
-✔️ Average ping is 36ms average (13ms min, 109ms max)
+✅ Ping is 25ms average, 13ms min, 109ms max.
 
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Checks the ping latency 
+.DESCRIPTION
+	This PowerShell script checks the ping latency from the local computer to some Internet hosts.
+.PARAMETER hosts
+	Specifies the hosts to check, seperated by comma (default is: amazon.com,bing.com,cnn.com,dropbox.com,facebook.com,google.com,live.com,twitter.com,youtube.com)
+.EXAMPLE
+	PS> ./check-ping
+	✅ Ping is 25ms average, 13ms min, 109ms max.
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+param([string]$hosts = "amazon.com,bing.com,cnn.com,dropbox.com,facebook.com,google.com,live.com,twitter.com,youtube.com")
+
+try {
+	Write-Progress "⏳ Pinging $hosts..."
+	$HostsArray = $hosts.Split(",")
+	$Pings = Test-Connection -count 1 -computerName $HostsArray
+
+	[int]$Min = 9999999
+	[int]$Max = [int]$Avg = 0
+	foreach($Ping in $Pings) {
+		if ($IsLinux) {	[int]$Latency = $Ping.latency } else { [int]$Latency = $Ping.ResponseTime }
+		if ($Latency -lt $Min) { $Min = $Latency }
+		if ($Latency -gt $Max) { $Max = $Latency }
+		$Avg += $Latency
+	}
+	$Avg /= $Pings.count
+	"✅ Ping is $($Avg)ms average, $($Min)ms min, $($Max)ms max"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of check-ping.ps1*

Docs/check-powershell.md

@@ -0,0 +1,59 @@
+## The *check-powershell.ps1* Script
+
+This PowerShell script queries and lists details of PowerShell.
+
+## Parameters
+```powershell
+check-powershell.ps1 [<CommonParameters>]
+
+[<CommonParameters>]
+    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
+    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
+```
+
+## Example
+```powershell
+PS> ./check-powershell
+
+```
+
+## Notes
+Author: Markus Fleschutz | License: CC0
+
+## Related Links
+https://github.com/fleschutz/PowerShell
+
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Query PowerShell details
+.DESCRIPTION
+	This PowerShell script queries and lists details of PowerShell.
+.EXAMPLE
+	PS> ./check-powershell
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	$Version = $PSVersionTable.PSVersion
+	$Edition = $PSVersionTable.PSEdition
+	$NumModules = (Get-Module).Count
+	$NumAliases = (Get-Alias).Count
+	if ($IsLinux) {
+		"✅ PowerShell $Version ($Edition edition) with $NumModules modules and $NumAliases aliases"
+	} else {
+		$NumCmdlets = (Get-Command -Command-Type cmdlet).Count
+		"✅ PowerShell $Version ($Edition edition) with $NumModules modules, $NumCmdlets cmdlets and $NumAliases aliases"
+	}
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
+*Generated by convert-ps2md.ps1 using the comment-based help of check-powershell.ps1*

Docs/check-ram.md

@@ -0,0 +1,81 @@
+## The *check-ram.ps1* Script
+
+check-ram.ps1 
+
+
+## Parameters
+```powershell
+
+
+[<CommonParameters>]
+    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
+    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
+```
+
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Checks the RAM 
+.DESCRIPTION
+	This PowerShell script queries and prints details of the installed RAM.
+.EXAMPLE
+	PS> ./check-ram
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+function GetRAMType { param([int]$Type)
+	switch($Type) {
+	2 { return "DRAM" }
+	5 { return "EDO RAM" }
+	6 { return "EDRAM" }
+	7 { return "VRAM" }
+	8 { return "SRAM" }
+	10 { return "ROM" }
+	11 { return "Flash RAM" }
+	12 { return "EEPROM" }
+	13 { return "FEPROM" }
+	14 { return "EPROM" }
+	15 { return "CDRAM" }
+	16 { return "3DRAM" }
+	17 { return "SDRAM" }
+	18 { return "SGRAM" }
+	19 { return "RDRAM" }
+	20 { return "DDR RAM" }
+	21 { return "DDR2 RAM" }
+	22 { return "DDR2 FB-DIMM" }
+	24 { return "DDR3 RAM" }
+	26 { return "DDR4 RAM" }
+	27 { return "DDR5 RAM" }
+	28 { return "DDR6 RAM" }
+	29 { return "DDR7 RAM" }
+	default { return "RAM" }
+	}
+}
+
+try {
+	if ($IsLinux) {
+		# TODO
+	} else {
+		$Banks = Get-WmiObject -Class Win32_PhysicalMemory
+		foreach ($Bank in $Banks) {
+			$Capacity = $Bank.Capacity / (1024 * 1024 * 1024)
+			$Type = GetRAMType $Bank.SMBIOSMemoryType
+			$Speed = $Bank.Speed
+			[float]$Voltage = $Bank.ConfiguredVoltage / 1000.0
+			$Manufacturer = $Bank.Manufacturer
+			$Location = "$($Bank.BankLabel)/$($Bank.DeviceLocator)"
+			"✅ $($Capacity)GB $($Type) at $($Location) ($($Speed)MHz, $($Voltage)V by $Manufacturer)"
+		}
+	}
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
+*Generated by convert-ps2md.ps1 using the comment-based help of check-ram.ps1*

Docs/check-repo.md

@@ -0,0 +1,116 @@
+## The *check-repo.ps1* Script
+
+This PowerShell script verifies the integrity of a local Git repository.
+
+## Parameters
+```powershell
+check-repo.ps1 [[-RepoDir] <String>] [<CommonParameters>]
+
+-RepoDir <String>
+    Specifies the path to the Git repository (current working dir by default)
+    
+    Required?                    false
+    Position?                    1
+    Default value                "$PWD"
+    Accept pipeline input?       false
+    Accept wildcard characters?  false
+
+[<CommonParameters>]
+    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
+    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
+```
+
+## Example
+```powershell
+PS> ./check-repo
+
+```
+
+## Notes
+Author: Markus Fleschutz | License: CC0
+
+## Related Links
+https://github.com/fleschutz/PowerShell
+
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Checks a Git repository
+.DESCRIPTION
+	This PowerShell script verifies the integrity of a local Git repository.
+.PARAMETER RepoDir
+	Specifies the path to the Git repository (current working dir by default)
+.EXAMPLE
+	PS> ./check-repo
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+param([string]$RepoDir = "$PWD")
+
+try {
+	$StopWatch = [system.diagnostics.stopwatch]::startNew()
+
+	Write-Host "⏳ (1/11) Searching for Git executable...  " -noNewline
+	& git --version
+	if ($lastExitCode -ne "0") { throw "Can't execute 'git' - make sure Git is installed and available" }
+
+	Write-Host "⏳ (2/11) Checking path...                 " -noNewline
+	$FullPath = Resolve-Path "$RepoDir"
+	if (!(Test-Path "$FullPath" -pathType Container)) { throw "Can't access folder: $FullPath" }
+	"$FullPath"
+
+	Write-Host "⏳ (3/11) Searching for 📂.git...          " -noNewline
+	if (!(Test-Path "$FullPath/.git" -pathType container)) { throw "Can't access folder: $FullPath/.git" }
+	"OK"
+
+	Write-Host "⏳ (4/11) Query remote URL...              " -noNewline
+	& git -C "$FullPath" remote get-url origin
+	if ($lastExitCode -ne "0") { throw "'git remote get-url origin' failed with exit code $lastExitCode" }
+
+	Write-Host "⏳ (5/11) Query current branch...          " -noNewline
+	& git -C "$FullPath" branch --show-current
+	if ($lastExitCode -ne "0") { throw "'git branch --show-current' failed with exit code $lastExitCode" }
+
+	Write-Host "⏳ (6/11) Trying to fetch...               " -noNewline
+	& git -C "$FullPath" fetch
+	if ($lastExitCode -ne "0") { throw "'git branch --show-current' failed with exit code $lastExitCode" }
+	Write-Host "OK"
+
+	Write-Host "⏳ (7/11) Query latest tag...              " -noNewline
+        $LatestTagCommitID = (git -C "$FullPath" rev-list --tags --max-count=1)
+        $LatestTagName = (git -C "$FullPath" describe --tags $LatestTagCommitID)
+        Write-Host "$LatestTagName (commit $LatestTagCommitID)"
+
+	Write-Host "⏳ (8/11) Verify data integrity..."
+	& git -C "$FullPath" fsck 
+	if ($lastExitCode -ne "0") { throw "'git fsck' failed with exit code $lastExitCode" }
+
+	Write-Host "⏳ (9/11) Run maintenance tasks..."
+	& git -C "$FullPath" maintenance run
+	if ($lastExitCode -ne "0") { throw "'git maintenance run' failed with exit code $lastExitCode" }
+
+	Write-Host "⏳ (10/11) Query submodule status...        " -noNewline
+	& git -C "$FullPath" submodule status
+	if ($lastExitCode -ne "0") { throw "'git submodule status' failed with exit code $lastExitCode" }
+	" "
+
+	Write-Host "⏳ (11/11) Query repository status...      " -noNewline
+	& git -C "$FullPath" status --short 
+	if ($lastExitCode -ne "0") { throw "'git status --short' failed with exit code $lastExitCode" }
+	" "
+
+	$RepoDirName = (Get-Item "$FullPath").Name
+	[int]$Elapsed = $StopWatch.Elapsed.TotalSeconds
+	"✔️ checked 📂$RepoDirName repo in $Elapsed sec"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
+*Generated by convert-ps2md.ps1 using the comment-based help of check-repo.ps1*

Docs/check-santa.md

@@ -1,4 +1,4 @@
-## check-santa.ps1 - Checks the time until Saint Nicholas Day
+## The *check-santa.ps1* Script
 
 This PowerShell script checks the time until Saint Nicholas Day and replies by text-to-speech (TTS).
 
@@ -18,9 +18,36 @@ PS> ./check-santa
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Checks the time until Saint Nicholas Day
+.DESCRIPTION
+	This PowerShell script checks the time until Saint Nicholas Day and replies by text-to-speech (TTS).
+.EXAMPLE
+	PS> ./check-santa
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	$Now = [DateTime]::Now
+	$Diff = [Datetime]("12/06/" + $Now.Year) – $Now
+
+	& "$PSScriptRoot/speak-english.ps1" "Saint Nicholas Day is in $($Diff.Days) days."
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of check-santa.ps1*

Docs/check-smart-devices.md

@@ -1,37 +1,93 @@
-## check-smart-devices.ps1 - Performs a selftest on your S.M.A.R.T. HDD/SSD devices.
+## The *check-smart-devices.ps1* Script
+
+check-smart-devices.ps1 
 
-This PowerShell script performs a selftest on your S.M.A.R.T. HDD/SSD devices.
-       It requires smartctl (smartmontools package) and admin rights.
 
 ## Parameters
 ```powershell
-check-smart-devices.ps1 [[-type] <String>] [<CommonParameters>]
 
--type <String>
-    Specifies the type of selftest: either short (default) or long
-    
-    Required?                    false
-    Position?                    1
-    Default value                short
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
 
 [<CommonParameters>]
     This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
     WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
 ```
 
-## Example
+## Source Code
 ```powershell
-PS> ./check-smart-devices
+<#
-✔️ short selftest started on S.M.A.R.T. device /dev/sda
+.SYNOPSIS
+	Checks SMART devices
+.DESCRIPTION
+	This PowerShell script queries S.M.A.R.T. HDD/SSD device details and prints it.
+.EXAMPLE
+	PS> ./check-smart-devices
+	✅ 1TB Samsung SSD 970 EVO via NVMe: 37°C, 2388 hours, 289x on, v2B2QEXE7, selftest passed
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
 
+function Bytes2String { param([int64]$Bytes)
+	if ($Bytes -lt 1000) { return "$Bytes bytes" }
+	$Bytes /= 1000
+	if ($Bytes -lt 1000) { return "$($Bytes)KB" }
+	$Bytes /= 1000
+	if ($Bytes -lt 1000) { return "$($Bytes)MB" }
+	$Bytes /= 1000
+	if ($Bytes -lt 1000) { return "$($Bytes)GB" }
+	$Bytes /= 1000
+	if ($Bytes -lt 1000) { return "$($Bytes)TB" }
+	$Bytes /= 1000
+	if ($Bytes -lt 1000) { return "$($Bytes)PB" }
+	$Bytes /= 1000
+	if ($Bytes -lt 1000) { return "$($Bytes)EB" }
+}
+
+try {
+	Write-Progress "⏳ Step 1/3 - Searching for smartctl executable..."
+	$Result = (smartctl --version)
+	if ($lastExitCode -ne "0") { throw "Can't execute 'smartctl' - make sure smartmontools are installed" }
+
+	Write-Progress "⏳ Step 2/3 - Scanning S.M.A.R.T devices..."
+	if ($IsLinux) {
+		$Devices = $(sudo smartctl --scan-open)
+	} else {
+		$Devices = $(smartctl --scan-open)
+	}
+	foreach($Device in $Devices) {
+		Write-Progress "⏳ Step 3/3 - Querying S.M.A.R.T devices..."
+		$Array = $Device.split(" ")
+		$Device = $Array[0]
+		if ("$Device" -eq "#") {
+			continue
+		} elseif ($IsLinux) {
+			$Details = (sudo smartctl --all --json $Device) | ConvertFrom-Json
+			$null = (sudo smartctl --test=short $Device)
+		} else {
+			$Details = (smartctl --all --json $Device) | ConvertFrom-Json
+			$null = (smartctl --test=short $Device)
+		}
+		$ModelName = $Details.model_name
+		$Protocol = $Details.device.protocol
+		[int64]$GBytes = $Details.user_capacity.bytes
+		if ($GBytes -gt 0) {
+			$Capacity = "$(Bytes2String $GBytes) "
+		} else {
+			$Capacity = ""
+		}
+		$Temp = $Details.temperature.current
+		$Firmware = $Details.firmware_version
+		$PowerOn = $Details.power_cycle_count
+		$Hours = $Details.power_on_time.hours
+		if ($Details.smart_status.passed) { $Status = "passed" } else { $Status = "FAILED" }
+		"✅ $($Capacity)$ModelName via $($Protocol): $($Temp)°C, $($Hours) hours, $($PowerOn)x on, v$($Firmware), selftest $Status"
+	}
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
 ```
 
-## Notes
-Author: Markus Fleschutz / License: CC0
-
-## Related Links
-https://github.com/fleschutz/PowerShell
-
 *Generated by convert-ps2md.ps1 using the comment-based help of check-smart-devices.ps1*

Docs/check-subnet-mask.md

@@ -1,4 +1,4 @@
-## check-subnet-mask.ps1 - Checks the given subnet mask for validity
+## The *check-subnet-mask.ps1* Script
 
 This PowerShell script checks the given subnet mask for validity.
 
@@ -28,9 +28,54 @@ PS> ./check-subnet-mask 255.255.255.0
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Checks the given subnet mask for validity
+.DESCRIPTION
+	This PowerShell script checks the given subnet mask for validity.
+.PARAMETER address
+	Specifies the subnet mask to check
+.EXAMPLE
+	PS> ./check-subnet-mask 255.255.255.0
+	✔️ subnet mask 255.255.255.0 is valid
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+param([string]$address = "")
+
+function IsSubNetMaskValid { param([string]$IP)
+	$RegEx = "^(254|252|248|240|224|192|128).0.0.0$|^255.(254|252|248|240|224|192|128|0).0.0$|^255.255.(254|252|248|240|224|192|128|0).0$|^255.255.255.(255|254|252|248|240|224|192|128|0)$"
+	if ($IP -match $RegEx) {
+		return $true
+	} else {
+		return $false
+	}
+}
+
+try {
+	if ($address -eq "" ) { $address = read-host "Enter subnet mask to validate" }
+
+	if (IsSubNetMaskValid $address) {
+		"✔️ subnet mask $Address is valid"
+		exit 0 # success
+	} else {
+		write-warning "Invalid subnet mask: $address"
+		exit 1
+	}
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of check-subnet-mask.ps1*

Docs/check-swap-space.md

@@ -1,4 +1,4 @@
-## check-swap-space.ps1 - Checks the swap space
+## The *check-swap-space.ps1* Script
 
 This PowerShell script checks the free swap space.
 
@@ -7,11 +7,11 @@ This PowerShell script checks the free swap space.
 check-swap-space.ps1 [[-MinLevel] <Int32>] [<CommonParameters>]
 
 -MinLevel <Int32>
-    Specifies the minimum level (50 GB by default)
+    Specifies the minimum level (10 GB by default)
     
     Required?                    false
     Position?                    1
-    Default value                50
+    Default value                10
     Accept pipeline input?       false
     Accept wildcard characters?  false
 
@@ -23,14 +23,79 @@ check-swap-space.ps1 [[-MinLevel] <Int32>] [<CommonParameters>]
 ## Example
 ```powershell
 PS> ./check-swap-space
-✔️ 1213 GB left for swap space (67 of 1280 GB used)
+✅ Swap space uses 63 GB of 1856 GB.
 
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Checks the swap space
+.DESCRIPTION
+	This PowerShell script checks the free swap space.
+.PARAMETER MinLevel
+	Specifies the minimum level (10 GB by default)
+.EXAMPLE
+	PS> ./check-swap-space
+	✅ Swap space uses 63 GB of 1856 GB.
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+param([int]$MinLevel = 10) # minimum level in GB
+
+function MB2String { param([int64]$Bytes)
+        if ($Bytes -lt 1000) { return "$($Bytes)MB" }
+        $Bytes /= 1000
+        if ($Bytes -lt 1000) { return "$($Bytes)GB" }
+        $Bytes /= 1000
+        if ($Bytes -lt 1000) { return "$($Bytes)TB" }
+        $Bytes /= 1000
+        if ($Bytes -lt 1000) { return "$($Bytes)PB" }
+        $Bytes /= 1000
+        if ($Bytes -lt 1000) { return "$($Bytes)EB" }
+}
+
+try {
+	[int]$Total = [int]$Used = [int]$Free = 0
+	if ($IsLinux) {
+		$Result = $(free --mega | grep Swap:)
+		[int]$Total = $Result.subString(5,14)
+		[int]$Used = $Result.substring(20,13)
+		[int]$Free = $Result.substring(32,11)
+	} else {
+		$Items = Get-WmiObject -class "Win32_PageFileUsage" -namespace "root\CIMV2" -computername localhost 
+		foreach ($Item in $Items) { 
+			$Total = $Item.AllocatedBaseSize
+			$Used = $Item.CurrentUsage
+			$Free = ($Total - $Used)
+		} 
+	}
+	if ($Total -eq 0) {
+        	"⚠️ No swap space configured!"
+	} elseif ($Free -lt $MinLevel) {
+		"⚠️ Only $(MB2String $Free) of $(MB2String $Total) swap space left to use!"
+	} elseif ($Used -eq 0) {
+		"✅ Swap space with $(MB2String $Total) reserved"
+	} elseif ($Used -lt $Free) {
+		"✅ Swap space uses $(MB2String $Used) of $(MB2String $Total)"
+	} else {
+		"✅ Swap space has $(MB2String $Free) of $(MB2String $Total) left to use"
+	}
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of check-swap-space.ps1*

Docs/check-symlinks.md

@@ -1,14 +1,14 @@
-## check-symlinks.ps1 - Checks every symlink in a folder
+## The *check-symlinks.ps1* Script
 
-This PowerShell script checks every symlink in a folder (including subfolders).
+This PowerShell script checks every symbolic link in a folder (including subfolders).
-Returns the number of broken symlinks as exit value.
+It returns the number of broken symlinks as exit value.
 
 ## Parameters
 ```powershell
-check-symlinks.ps1 [[-folder] <String>] [<CommonParameters>]
+check-symlinks.ps1 [[-Folder] <String>] [<CommonParameters>]
 
--folder <String>
+-Folder <String>
-    Specifies the path to the directory tree
+    Specifies the path to the folder
     
     Required?                    false
     Position?                    1
@@ -23,15 +23,73 @@ check-symlinks.ps1 [[-folder] <String>] [<CommonParameters>]
 
 ## Example
 ```powershell
-PS> ./check-symlinks .
+PS> ./check-symlinks C:\Users
-✔️ 0 out of 10 symlinks are broken in 📂/home/markus
 
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Checks symlinks in a folder
+.DESCRIPTION
+	This PowerShell script checks every symbolic link in a folder (including subfolders).
+	It returns the number of broken symlinks as exit value.
+.PARAMETER folder
+	Specifies the path to the folder
+.EXAMPLE
+	PS> ./check-symlinks C:\Users
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+param([string]$Folder = "")
+
+try {
+	if ($Folder -eq "" ) { $Folder = read-host "Enter the path to the folder" }
+
+	$StopWatch = [system.diagnostics.stopwatch]::startNew()
+	$FullPath = Resolve-Path "$Folder"
+	"⏳ Checking symlinks at 📂$FullPath including subfolders..."
+
+	[int]$NumTotal = [int]$NumBroken = 0
+	Get-ChildItem $FullPath -recurse  | Where { $_.Attributes -match "ReparsePoint" } | ForEach-Object {
+		$Symlink = $_.FullName
+		$Target = ($_ | Select-Object -ExpandProperty Target -ErrorAction Ignore)
+		if ($Target) {
+			$path = $_.FullName + "\..\" + ($_ | Select-Object -ExpandProperty Target)
+			$item = Get-Item $path -ErrorAction Ignore
+			if (!$item) {
+				$NumBroken++
+				"Broken symlink #$($NumBroken): $Symlink ⭢ $Target"
+			}
+		}
+		$NumTotal++
+	}
+
+	[int]$Elapsed = $StopWatch.Elapsed.TotalSeconds
+	if ($NumTotal -eq 0) {
+		"✔️ found no symlink at 📂$FullPath in $Elapsed sec" 
+	} elseif ($NumBroken -eq 0) {
+		"✔️ found $NumTotal valid symlinks at 📂$FullPath in $Elapsed sec"
+	} elseif ($NumBroken -eq 1) {
+		"✔️ found $NumBroken broken symlink out of $NumTotal at 📂$FullPath in $Elapsed sec"
+	} else {
+		"✔️ found $NumBroken broken symlinks out of $NumTotal at 📂$FullPath in $Elapsed sec"
+	}
+	exit $NumBroken
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of check-symlinks.ps1*

Docs/check-time-zone.md

@@ -1,6 +1,6 @@
-## check-time-zone.ps1 - Determines the time zone
+## The *check-time-zone.ps1* Script
 
-This PowerShell script determines and returns the current time zone.
+This PowerShell script determines and prints the current time zone.
 
 ## Parameters
 ```powershell
@@ -18,9 +18,37 @@ PS> ./check-time-zone
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Checks the time zone setting
+.DESCRIPTION
+	This PowerShell script determines and prints the current time zone.
+.EXAMPLE
+	PS> ./check-time-zone
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	[system.threading.thread]::currentThread.currentCulture = [system.globalization.cultureInfo]"en-US"
+	$Time = $((Get-Date).ToShortTimeString())
+	$TZ = (Get-Timezone)
+	if ($TZ.SupportsDaylightSavingTime) { $DST=" & +01:00:00 DST" } else { $DST="" }
+	"✅ $Time in $($TZ.Id) (UTC+$($TZ.BaseUtcOffset)$DST)."
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of check-time-zone.ps1*

Docs/check-uptime.md

@@ -1,6 +1,6 @@
-## check-uptime.ps1 - Determines the uptime
+## The *check-uptime.ps1* Script
 
-This PowerShell script determines and says the uptime by text-to-speech (TTS).
+This PowerShell script queries and prints the uptime.
 
 ## Parameters
 ```powershell
@@ -18,9 +18,59 @@ PS> ./check-uptime
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Check uptime 
+.DESCRIPTION
+	This PowerShell script queries and prints the uptime.
+.EXAMPLE
+	PS> ./check-uptime
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	if ($IsLinux) {
+		$Uptime = (get-uptime)
+	} else {
+		$BootTime = Get-WinEvent -ProviderName eventlog | Where-Object {$_.Id -eq 6005} | Select-Object TimeCreated -First 1 
+		$Uptime = New-TimeSpan -Start $BootTime.TimeCreated.Date -End (Get-Date)
+	}
+	$Days = $Uptime.Days
+	$Hours = $Uptime.Hours
+	$Minutes = $Uptime.Minutes 
+
+	$Reply = "Up for "
+	if ($Days -eq "1") {
+		$Reply += "1 day, "
+	} elseif ($Days -ne "0") {
+		$Reply += "$Days days, "
+	}
+	if ($Hours -eq "1") {
+		$Reply += "1 hour, "
+	} elseif ($Hours -ne "0") {
+		$Reply += "$Hours hours, "
+	}
+	if ($Minutes -eq "1") {
+		$Reply += "1 minute"
+	} else {
+		$Reply += "$Minutes minutes"
+	}
+	"✅ $Reply."
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of check-uptime.ps1*

Docs/check-vpn.md

@@ -1,6 +1,6 @@
-## check-vpn.ps1 - Checks the VPN connections
+## The *check-vpn.ps1* Script
 
-This PowerShell script checks the status of all available VPN connections.
+This PowerShell script queries and prints the status of any VPN connection.
 
 ## Parameters
 ```powershell
@@ -18,9 +18,43 @@ PS> ./check-vpn
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Checks the VPN connection
+.DESCRIPTION
+	This PowerShell script queries and prints the status of any VPN connection.
+.EXAMPLE
+	PS> ./check-vpn
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	$NoVPN = $true
+	if ($IsLinux) {
+		# TODO
+	} else {
+		$Connections = (Get-VPNConnection)
+		foreach($Connection in $Connections) {
+			"✅ VPN '$($Connection.Name)' is $($Connection.ConnectionStatus)"
+			$NoVPN = $false
+		}
+	}
+	if ($NoVPN) { "⚠️ No VPN connection" }
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of check-vpn.ps1*

Docs/check-weather.md

@@ -1,4 +1,4 @@
-## check-weather.ps1 - Checks the weather
+## The *check-weather.ps1* Script
 
 This PowerShell script checks the current weather report.
 
@@ -27,9 +27,52 @@ PS> ./check-weather
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Checks the weather 
+.DESCRIPTION
+	This PowerShell script checks the current weather report.
+.PARAMETER location
+	Specifies the location to use (determined automatically per default)
+.EXAMPLE
+	PS> ./check-weather
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+param([string]$location = "") # empty means determine automatically
+
+try {
+	$Weather = (Invoke-WebRequest http://wttr.in/${location}?format=j1 -userAgent "curl" -useBasicParsing).Content | ConvertFrom-Json
+
+	$Temp = $Weather.current_condition.temp_C
+	$Precip = $Weather.current_condition.precipMM
+	$Humidity = $Weather.current_condition.humidity
+	$Pressure = $Weather.current_condition.pressure
+	$WindSpeed = $Weather.current_condition.windspeedKmph
+	$WindDir = $Weather.current_condition.winddir16Point
+	$UV = $Weather.current_condition.uvIndex
+	$Visib = $Weather.current_condition.visibility
+	$Clouds = $Weather.current_condition.cloudcover
+	$Desc = $Weather.current_condition.weatherDesc.value
+	$Area = $Weather.nearest_area.areaName.value
+	$Region = $Weather.nearest_area.region.value
+
+	& "$PSScriptRoot/speak-english.ps1" "$($Temp)°C, $($Precip)mm rain, $($Humidity)% humidity, $($WindSpeed)km/h wind from $WindDir with $($Clouds)% clouds and $($Visib)km visibility at $Area ($Region)."
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of check-weather.ps1*

Docs/check-week.md

@@ -1,4 +1,4 @@
-## check-week.ps1 - Determines the week number
+## The *check-week.ps1* Script
 
 This PowerShell script determines and speaks the current week number by text-to-speech (TTS).
 
@@ -14,14 +14,38 @@ check-week.ps1 [<CommonParameters>]
 ## Example
 ```powershell
 PS> ./check-week
-✔️ It's week #4.
 
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Determines the week number 
+.DESCRIPTION
+	This PowerShell script determines and speaks the current week number by text-to-speech (TTS).
+.EXAMPLE
+	PS> ./check-week
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	$WeekNo = (Get-Date -UFormat %V)
+	& "$PSScriptRoot/speak-english.ps1" "It's week #$WeekNo."
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of check-week.ps1*

Docs/check-wind.md

@@ -1,4 +1,4 @@
-## check-wind.ps1 - Checks the wind conditions
+## The *check-wind.ps1* Script
 
 This PowerShell script determines the current wind conditions and replies by text-to-speech (TTS).
 
@@ -27,9 +27,43 @@ PS> ./check-wind
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Checks the wind conditions
+.DESCRIPTION
+	This PowerShell script determines the current wind conditions and replies by text-to-speech (TTS).
+.PARAMETER location
+	Specifies the location to use (determined automatically per default)
+.EXAMPLE
+	PS> ./check-wind
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+param([string]$location = "") # empty means determine automatically
+
+try {
+	$Weather = (Invoke-WebRequest http://wttr.in/${location}?format=j1 -userAgent "curl" -useBasicParsing).Content | ConvertFrom-Json
+	$WindSpeed = $Weather.current_condition.windspeedKmph
+	$WindDir = $Weather.current_condition.winddir16Point
+	$Area = $Weather.nearest_area.areaName.value
+	$Region = $Weather.nearest_area.region.value
+
+	& "$PSScriptRoot/speak-english.ps1" "$($WindSpeed)km/h wind from $WindDir at $Area ($Region)."
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of check-wind.ps1*

Docs/check-windows-system-files.md

@@ -1,4 +1,4 @@
-## check-windows-system-files.ps1 - Checks the validity of the Windows system files (requires admin rights)
+## The *check-windows-system-files.ps1* Script
 
 This PowerShell script checks the validity of the Windows system files. It requires admin rights.
 
@@ -19,9 +19,39 @@ PS> ./check-windows-system-files
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Checks the validity of the Windows system files (requires admin rights)
+.DESCRIPTION
+	This PowerShell script checks the validity of the Windows system files. It requires admin rights.
+.EXAMPLE
+	PS> ./check-windows-system-files
+	✔️ checked Windows system files
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+#Requires -RunAsAdministrator
+
+try {
+	sfc /verifyOnly
+	if ($lastExitCode -ne "0") { throw "'sfc /verifyOnly' failed" }
+
+	"✔️ checked Windows system files"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of check-windows-system-files.ps1*

Docs/check-xml-file.md

@@ -1,4 +1,4 @@
-## check-xml-file.ps1 - Checks the given XML file for validity
+## The *check-xml-file.ps1* Script
 
 This PowerShell script checks the given XML file for validity.
 
@@ -28,9 +28,58 @@ PS> ./check-xml-file myfile.xml
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Checks the given XML file for validity
+.DESCRIPTION
+	This PowerShell script checks the given XML file for validity.
+.PARAMETER file
+	Specifies the path to the XML file to check
+.EXAMPLE
+	PS> ./check-xml-file myfile.xml
+	✔️ XML file is valid
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+param([string]$file = "")
+
+try {
+	if ($file -eq "" ) { $file = read-host "Enter path to XML file" }
+
+	$XmlFile = Get-Item $file
+	
+	$script:ErrorCount = 0
+	
+	# Perform the XSD Validation
+	$ReaderSettings = New-Object -TypeName System.Xml.XmlReaderSettings
+	$ReaderSettings.ValidationType = [System.Xml.ValidationType]::Schema
+	$ReaderSettings.ValidationFlags = [System.Xml.Schema.XmlSchemaValidationFlags]::ProcessInlineSchema -bor [System.Xml.Schema.XmlSchemaValidationFlags]::ProcessSchemaLocation
+	$ReaderSettings.add_ValidationEventHandler({ $script:ErrorCount++ })
+	$Reader = [System.Xml.XmlReader]::Create($XmlFile.FullName, $ReaderSettings)
+	while ($Reader.Read()) { }
+	$Reader.Close()
+	
+	if ($script:ErrorCount -gt 0) {
+		write-warning "Invalid XML file"
+		exit 1
+	} 
+
+	"✔️ XML file is valid"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of check-xml-file.ps1*

Docs/clean-repo.md

@@ -1,6 +1,7 @@
-## clean-repo.ps1 - Cleans a Git repository from untracked files (including submodules)
+## The *clean-repo.ps1* Script
 
-This PowerShell script cleans a Git repository from untracked files (including submodules).
+This PowerShell script deletes all untracked files and folders in a Git repository (including submodules).
+NOTE: To be used with care! This cannot be undone!
 
 ## Parameters
 ```powershell
@@ -23,15 +24,65 @@ clean-repo.ps1 [[-RepoDir] <String>] [<CommonParameters>]
 ## Example
 ```powershell
 PS> ./clean-repo C:\MyRepo
-🧹 Cleaning from untracked files...
-✔️ cleaned Git repository 📂C:\MyRepo in 0 sec
 
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Clean a repository
+.DESCRIPTION
+	This PowerShell script deletes all untracked files and folders in a Git repository (including submodules).
+	NOTE: To be used with care! This cannot be undone!
+.PARAMETER RepoDir
+	Specifies the path to the Git repository
+.EXAMPLE
+	PS> ./clean-repo C:\MyRepo
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+param([string]$RepoDir = "$PWD")
+
+try {
+	$StopWatch = [system.diagnostics.stopwatch]::startNew()
+
+	Write-Host "⏳ (1/4) Searching for Git executable...  " -noNewline
+	& git --version
+	if ($lastExitCode -ne "0") { throw "Can't execute 'git' - make sure Git is installed and available" }
+
+	$RepoDirName = (Get-Item "$RepoDir").Name
+	"⏳ (2/4) Checking Git repository 📂$RepoDirName..."
+	if (-not(Test-Path "$RepoDir" -pathType container)) { throw "Can't access folder '$RepoDir' - maybe a typo or missing folder permissions?" }
+
+	"⏳ (3/4) Removing untracked files in repository..."
+	& git -C "$RepoDir" clean -xfd -f # to delete all untracked files in the main repo
+	if ($lastExitCode -ne "0") {
+		"'git clean' failed with exit code $lastExitCode, retrying once..."
+		& git -C "$RepoDir" clean -xfd -f 
+		if ($lastExitCode -ne "0") { throw "'git clean' failed with exit code $lastExitCode" }
+	}
+
+	"⏳ (4/4) Removing untracked files in submodules..."
+	& git -C "$RepoDir" submodule foreach --recursive git clean -xfd -f # to delete all untracked files in the submodules
+	if ($lastExitCode -ne "0") { throw "'git clean' in the submodules failed with exit code $lastExitCode" }
+
+	[int]$Elapsed = $StopWatch.Elapsed.TotalSeconds
+	"✔️ cleaned Git repository 📂$RepoDirName in $Elapsed sec"
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of clean-repo.ps1*

Docs/clean-repos.md

@@ -1,4 +1,4 @@
-## clean-repos.ps1 - Cleans all Git repositories in a folder from untracked files
+## The *clean-repos.ps1* Script
 
 This PowerShell script cleans all Git repositories in a folder from untracked files (including submodules).
 
@@ -27,9 +27,63 @@ PS> ./clean-repos C:\MyRepos
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Cleans all Git repositories in a folder from untracked files 
+.DESCRIPTION
+	This PowerShell script cleans all Git repositories in a folder from untracked files (including submodules).
+.PARAMETER ParentDir
+	Specifies the path to the parent folder
+.EXAMPLE
+	PS> ./clean-repos C:\MyRepos
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+param([string]$ParentDir = "$PWD")
+
+try {
+	$StopWatch = [system.diagnostics.stopwatch]::startNew()
+
+	Write-Host "⏳ (1) Searching for Git executable...  " -noNewline
+        & git --version
+        if ($lastExitCode -ne "0") { throw "Can't execute 'git' - make sure Git is installed and available" }
+
+        $ParentDirName = (Get-Item "$ParentDir").Name
+        Write-Host "⏳ (2) Checking parent folder 📂$ParentDirName...  " -noNewline
+        if (-not(Test-Path "$ParentDir" -pathType container)) { throw "Can't access folder: $ParentDir" }
+        $Folders = (Get-ChildItem "$ParentDir" -attributes Directory)
+        $NumFolders = $Folders.Count
+        Write-Host "$NumFolders subfolders found"
+
+	[int]$Step = 2
+	foreach ($Folder in $Folders) {
+		$FolderName = (Get-Item "$Folder").Name
+		$Step++
+		"⏳ ($Step/$($NumFolders + 2)) Cleaning 📂$FolderName..."
+
+		& git -C "$Folder" clean -xfd -f # force + recurse into dirs + don't use the standard ignore rules
+		if ($lastExitCode -ne "0") { throw "'git clean -xfd -f' failed with exit code $lastExitCode" }
+
+		& git -C "$Folder" submodule foreach --recursive git clean -xfd -f 
+		if ($lastExitCode -ne "0") { throw "'git clean -xfd -f' in submodules failed with exit code $lastExitCode" }
+	}
+	[int]$Elapsed = $StopWatch.Elapsed.TotalSeconds
+	"✔️ cleaned $NumFolders Git repositories at 📂$ParentDirName in $Elapsed sec."
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of clean-repos.ps1*

Docs/clear-dns-cache.md

@@ -0,0 +1,55 @@
+## The *clear-dns-cache.ps1* Script
+
+This PowerShell script clears the DNS client cache of the local computer.
+
+## Parameters
+```powershell
+clear-dns-cache.ps1 [<CommonParameters>]
+
+[<CommonParameters>]
+    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
+    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
+```
+
+## Example
+```powershell
+PS> ./clear-dns-cache
+
+```
+
+## Notes
+Author: Markus Fleschutz | License: CC0
+
+## Related Links
+https://github.com/fleschutz/PowerShell
+
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Clears the DNS cache
+.DESCRIPTION
+	This PowerShell script clears the DNS client cache of the local computer.
+.EXAMPLE
+	PS> ./clear-dns-cache
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	$StopWatch = [system.diagnostics.stopwatch]::startNew()
+
+	Clear-DnsClientCache
+
+	[int]$Elapsed = $StopWatch.Elapsed.TotalSeconds
+	"✔️ cleared DNS cache in $Elapsed ms."
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
+*Generated by convert-ps2md.ps1 using the comment-based help of clear-dns-cache.ps1*

Docs/clear-recycle-bin.md

@@ -1,4 +1,4 @@
-## clear-recycle-bin.ps1 - Clears the recycle bin folder
+## The *clear-recycle-bin.ps1* Script
 
 This PowerShell script removes the content of the recycle bin folder permanently.
 IMPORTANT NOTE: this cannot be undo!
@@ -19,9 +19,37 @@ PS> ./clear-recycle-bin
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Clears the recycle bin folder
+.DESCRIPTION
+	This PowerShell script removes the content of the recycle bin folder permanently.
+	IMPORTANT NOTE: this cannot be undo!
+.EXAMPLE
+	PS> ./clear-recycle-bin
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+try {
+	Clear-RecycleBin -Confirm:$false
+	if ($lastExitCode -ne "0") { throw "'Clear-RecycleBin' failed" }
+
+	& "$PSScriptRoot/speak-english.ps1" "It's clean now."
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of clear-recycle-bin.ps1*

Docs/clone-repos.md

@@ -1,4 +1,4 @@
-## clone-repos.ps1 - Clones well-known Git repositories into a folder
+## The *clone-repos.ps1* Script
 
 This PowerShell script clones well-known Git repositories into a folder.
 
@@ -26,9 +26,85 @@ PS> ./clone-repos C:\Repos
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Clones Git repositories
+.DESCRIPTION
+	This PowerShell script clones well-known Git repositories into a folder.
+.PARAMETER folder
+	Specifies the target folder (default is current working directory)
+.EXAMPLE
+	PS> ./clone-repos C:\Repos
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+param([string]$FolderPath = "$PWD")
+
+try {
+	$StopWatch = [system.diagnostics.stopwatch]::startNew()
+
+	Write-Host "⏳ (1) Searching for Git executable...  " -noNewline
+	& git --version
+	if ($lastExitCode -ne "0") { throw "Can't execute 'git' - make sure Git is installed and available" }
+
+	Write-Host "⏳ (2) Loading database table from Data/git-repos.csv...  " -noNewline
+	$Table = Import-CSV "$PSScriptRoot/../Data/git-repos.csv"
+	$NumEntries = $Table.count
+	Write-Host "$NumEntries entries found"
+
+	$ParentFolderName = (Get-Item "$FolderPath").Name
+	"⏳ (3) Checking target folder 📂$ParentFolderName..."
+	if (-not(Test-Path "$FolderPath" -pathType container)) { throw "Can't access directory: $FolderPath" }
+	
+
+	[int]$Step = 3
+	[int]$Cloned = 0
+	[int]$Skipped = 0
+	foreach($Row in $Table) {
+		[string]$Group = $Row.GROUP
+		[string]$FolderName = $Row.FOLDERNAME
+		[string]$Branch = $Row.BRANCH
+		[string]$Full = $Row.FULL
+		[string]$URL = $Row.URL
+		$Step++
+
+		if (Test-Path "$FolderPath/$FolderName" -pathType container) {
+			"⏳ ($Step/$($NumEntries + 4)) Skipping 📂$($FolderName), it exists already..."
+			$Skipped++
+			continue
+		}
+		if ($Full -eq "yes") {
+			"⏳ ($Step/$($NumEntries + 4)) Cloning into 📂$($FolderName) ($Branch branch with full history)..."
+			& git clone --branch "$Branch" --recurse-submodules "$URL" "$FolderPath/$FolderName"
+			if ($lastExitCode -ne "0") { throw "'git clone --branch $Branch $URL' failed with exit code $lastExitCode" }
+		} else {
+			"⏳ ($Step/$($NumEntries + 4)) Cloning $Branch branch into 📂$FolderName..."
+			& git clone --branch "$Branch" --single-branch --recurse-submodules "$URL" "$FolderPath/$FolderName"
+			if ($lastExitCode -ne "0") { throw "'git clone --branch $Branch $URL' failed with exit code $lastExitCode" }
+		}
+		$Cloned++
+	}
+	[int]$Elapsed = $StopWatch.Elapsed.TotalSeconds
+	if ($Cloned -eq 1) {
+		"✔️ 1 Git repository cloned into 📂$ParentFolderName in $Elapsed sec ($Skipped skipped)."
+	} else {
+		"✔️ $Cloned Git repos cloned into 📂$ParentFolderName in $Elapsed sec ($Skipped skipped)."
+	}
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
+	exit 1
+}
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of clone-repos.ps1*

Docs/close-calculator.md

@@ -1,4 +1,4 @@
-## close-calculator.ps1 - Closes the calculator application
+## The *close-calculator.ps1* Script
 
 This PowerShell script closes the calculator application gracefully.
 
@@ -18,9 +18,32 @@ PS> ./close-calculator
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Closes the calculator application
+.DESCRIPTION
+	This PowerShell script closes the calculator application gracefully.
+.EXAMPLE
+	PS> ./close-calculator
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+TaskKill /im Calculator.exe /f /t
+if ($lastExitCode -ne "0") {
+	& "$PSScriptRoot/speak-english.ps1" "Sorry, calculator isn't running."
+	exit 1
+}
+exit 0 # success
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of close-calculator.ps1*

Docs/close-chrome.md

@@ -1,4 +1,4 @@
-## close-chrome.ps1 - Closes the Chrome browser
+## The *close-chrome.ps1* Script
 
 This PowerShell script closes the Google Chrome Web browser gracefully.
 
@@ -18,9 +18,28 @@ PS> ./close-chrome
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Closes the Chrome browser
+.DESCRIPTION
+	This PowerShell script closes the Google Chrome Web browser gracefully.
+.EXAMPLE
+	PS> ./close-chrome
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+& "$PSScriptRoot/close-program.ps1" "Google Chrome" "chrome" "chrome"
+exit 0 # success
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of close-chrome.ps1*

Docs/close-cortana.md

@@ -1,4 +1,4 @@
-## close-cortana.ps1 - Closes Microsoft's Cortana application
+## The *close-cortana.ps1* Script
 
 This PowerShell script closes Microsoft's Cortana application gracefully.
 
@@ -18,9 +18,28 @@ PS> ./close-cortana
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Closes Microsoft's Cortana application
+.DESCRIPTION
+	This PowerShell script closes Microsoft's Cortana application gracefully.
+.EXAMPLE
+	PS> ./close-cortana
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+& "$PSScriptRoot/close-program.ps1" "Cortana" "Cortana" "Cortana"
+exit 0 # success
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of close-cortana.ps1*

Docs/close-edge.md

@@ -1,4 +1,4 @@
-## close-edge.ps1 - Closes the Edge browser
+## The *close-edge.ps1* Script
 
 This PowerShell script closes the Microsoft Edge Web browser gracefully.
 
@@ -18,9 +18,32 @@ PS> ./close-edge
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Closes the Edge browser
+.DESCRIPTION
+	This PowerShell script closes the Microsoft Edge Web browser gracefully.
+.EXAMPLE
+	PS> ./close-edge
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+TaskKill /im msedge.exe /f /t
+if ($lastExitCode -ne "0") {
+	& "$PSScriptRoot/speak-english.ps1" "Sorry, Microsoft Edge isn't running."
+	exit 1
+}
+exit 0 # success
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of close-edge.ps1*

Docs/close-file-explorer.md

@@ -1,4 +1,4 @@
-## close-file-explorer.ps1 - Closes the File Explorer
+## The *close-file-explorer.ps1* Script
 
 This PowerShell script closes the Microsoft File Explorer application gracefully.
 
@@ -18,9 +18,28 @@ PS> ./close-file-explorer
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Closes the File Explorer 
+.DESCRIPTION
+	This PowerShell script closes the Microsoft File Explorer application gracefully.
+.EXAMPLE
+	PS> ./close-file-explorer
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+(New-Object -ComObject Shell.Application).Windows() | %{$_.quit()}
+exit 0 # success
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of close-file-explorer.ps1*

Docs/close-firefox.md

@@ -1,4 +1,4 @@
-## close-firefox.ps1 - Closes the Firefox browser
+## The *close-firefox.ps1* Script
 
 This PowerShell script closes the Mozilla Firefox Web browser gracefully.
 
@@ -18,9 +18,28 @@ PS> ./close-firefox
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Closes the Firefox browser 
+.DESCRIPTION
+	This PowerShell script closes the Mozilla Firefox Web browser gracefully.
+.EXAMPLE
+	PS> ./close-firefox
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+& "$PSScriptRoot/close-program.ps1" "Mozilla Firefox" "firefox" "firefox"
+exit 0 # success
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of close-firefox.ps1*

Docs/close-git-extensions.md

@@ -1,4 +1,4 @@
-## close-git-extensions.ps1 - Closes the Git Extensions app
+## The *close-git-extensions.ps1* Script
 
 This PowerShell script closes the Git Extensions application gracefully.
 
@@ -18,9 +18,32 @@ PS> ./close-git-extensions
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Closes the Git Extensions app
+.DESCRIPTION
+	This PowerShell script closes the Git Extensions application gracefully.
+.EXAMPLE
+	PS> ./close-git-extensions
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+TaskKill /im GitExtensions.exe
+if ($lastExitCode -ne "0") {
+	& "$PSScriptRoot/speak-english.ps1" "Sorry, Git Extensions isn't running."
+	exit 1
+}
+exit 0 # success
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of close-git-extensions.ps1*

Docs/close-magnifier.md

@@ -1,4 +1,4 @@
-## close-magnifier.ps1 - Closes the Magnifier
+## The *close-magnifier.ps1* Script
 
 This PowerShell script closes the Windows Screen Magnifier application gracefully.
 
@@ -18,9 +18,28 @@ PS> ./close-magnifier
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Closes the Magnifier
+.DESCRIPTION
+	This PowerShell script closes the Windows Screen Magnifier application gracefully.
+.EXAMPLE
+	PS> ./close-magnifier
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+tskill magnify
+exit 0 # success
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of close-magnifier.ps1*

Docs/close-microsoft-paint.md

@@ -1,4 +1,4 @@
-## close-microsoft-paint.ps1 - Closes the Microsoft Paint app
+## The *close-microsoft-paint.ps1* Script
 
 This PowerShell script closes the Microsoft Paint application gracefully.
 
@@ -18,9 +18,32 @@ PS> ./close-microsoft-paint
 ```
 
 ## Notes
-Author: Markus Fleschutz / License: CC0
+Author: Markus Fleschutz | License: CC0
 
 ## Related Links
 https://github.com/fleschutz/PowerShell
 
+## Source Code
+```powershell
+<#
+.SYNOPSIS
+	Closes the Microsoft Paint app 
+.DESCRIPTION
+	This PowerShell script closes the Microsoft Paint application gracefully.
+.EXAMPLE
+	PS> ./close-microsoft-paint
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+TaskKill /im mspaint.exe
+if ($lastExitCode -ne "0") {
+	& "$PSScriptRoot/speak-english.ps1" "Sorry, Microsoft Paint isn't running."
+	exit 1
+}
+exit 0 # success
+```
+
 *Generated by convert-ps2md.ps1 using the comment-based help of close-microsoft-paint.ps1*